Skip to content
Knowledge base

Error codes

Every refusal realuptime sends carries one stable RU-XXXX code, banded by domain. Codes never change meaning and are never reused: the page you bookmark today explains the same refusal forever.

How the codes are organized

The first digit is the domain band: 1xxx authentication and API keys, 2xxx rate limits, quotas and billing, 3xxx monitors, checks and agents, 4xxx realuptime errors ingest, 5xxx status pages and incidents, 6xxx outages and the public API. API responses carry the code as a code field beside the human-readable error; on-screen messages show it in parentheses.

1xxx: Authentication & API keys

  • RU-1001: Missing API credentials (HTTP 401)
  • RU-1002: Invalid or revoked API key (HTTP 401)
  • RU-1003: API access requires a paid plan (HTTP 403)
  • RU-1004: API key is read-only (HTTP 403)
  • RU-1005: Free plans get read-only MCP access

2xxx: Rate limits, quotas & billing

  • RU-2001: Too many failed authentication attempts (HTTP 429)
  • RU-2002: API read rate limit exceeded (HTTP 429)
  • RU-2003: API write rate limit exceeded (HTTP 429)
  • RU-2004: Plan monitor limit reached (HTTP 403)
  • RU-2005: Already subscribed

3xxx: Monitors, checks & agents

  • RU-3001: Invalid check request (HTTP 400)
  • RU-3002: Monitor target refused (HTTP 400)
  • RU-3003: Check not found (HTTP 404)
  • RU-3004: Invalid response assertions (HTTP 400)
  • RU-3005: Agent request refused (opaque 404) (HTTP 404)

4xxx: realuptime errors ingest

  • RU-4001: Error event quota reached (HTTP 429)
  • RU-4002: Ingest key revoked (HTTP 403)
  • RU-4003: Ingest rate limited (HTTP 429)
  • RU-4004: Malformed error batch (HTTP 400)
  • RU-4005: Account does not have realuptime errors (HTTP 403)
  • RU-4006: Errors project or issue not found (HTTP 404)
  • RU-4007: Invalid errors API request (HTTP 400)

5xxx: Status pages & incidents

  • RU-5001: Invalid incident request (HTTP 400)
  • RU-5002: Incident not found or not creatable (HTTP 404)
  • RU-5003: Incident conflicts with live outage state (HTTP 409)

6xxx: Outages & the public API

  • RU-6001: Service not covered by the outage tracker (HTTP 404)
  • RU-6002: Invalid outage query (HTTP 400)
  • RU-6003: Public outage API rate limited (HTTP 429)