Every RTC error carries a stable, machine-readable code . Switch on the
code, never on the message text: messages may be reworded, codes are never
renamed or reused for another meaning.
Default. Without a version header, errors keep their original shape, so
existing integrations are unaffected:
{ "error" : " Your plan allows 2 webhook endpoints " , "code" : " WEBHOOK_ENDPOINT_LIMIT " }
code is present on errors that have a specific code. Older errors may only
carry error; the X-Error-Code header always names the code.
Structured envelope. Send RTC-Version: 2026-11-01 with a request to
receive the structured envelope:
curl https://api.rtc.champrep.com/v1/webhooks/endpoints \
--header " Authorization: Bearer $RTC_API_KEY " \
--header " RTC-Version: 2026-11-01 " \
--header " Content-Type: application/json " \
--data ' { "url": "https://hooks.example.com/rtc" } '
"code" : " WEBHOOK_ENDPOINT_LIMIT " ,
"message" : " Your plan allows 2 webhook endpoints " ,
"details" : { "limit" : 2 , "used" : 2 },
"requestId" : " 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21 " ,
"docUrl" : " https://docs.champrep.com/services/rtc/errors/#webhook-endpoint-limit "
Field Meaning codeStable code from the catalog messageHuman-readable explanation; do not parse it detailsOptional structured context, for example limit and used, or issues (the invalid fields) for INVALID_REQUEST requestIdThe id of this request, also sent as X-Request-Id retryabletrue when retrying the same request later can succeeddocUrlLink to this code’s entry below
The response echoes the version it applied in the RTC-Version header. A date
before 2026-11-01 keeps the default shape. See versioning .
Header When Meaning X-Request-IdEvery response Unique id of the request. Include it when you contact support. X-Error-CodeEvery error The stable code, in both response shapes Retry-After429, and some 503Seconds to wait before retrying X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetAuthenticated responses See rate limits
retryable: false (4xx other than 429): fix the request, credential,
plan or state first. Repeating it unchanged gives the same answer.
retryable: true: retry with exponential backoff and jitter, honouring
Retry-After. Retry writes only when the operation is idempotent or after
reconciling its result.
401: the credential is missing, expired or revoked. 403: the credential
is valid but lacks a scope, project access or plan entitlement.
404 also covers resources that belong to someone else. Never probe other
customers’ identifiers.
GET /v1/error-codes (no authentication) returns the current catalog as
{ "codes": [{ "code", "status", "retryable", "description" }] }. New codes
may be added at any time; treat an unknown code like the generic code of its
HTTP status.
Code HTTP Retryable Meaning INVALID_REQUEST400 no The request is malformed or a field is invalid (details.issues lists the fields). UNAUTHENTICATED401 no Missing, invalid or expired credentials. PAYMENT_REQUIRED402 no A payment is due before this can be used. FORBIDDEN403 no The credential is valid but not allowed to do this. NOT_FOUND404 no The resource does not exist or is not visible to this credential. CONFLICT409 no The request conflicts with the current state. PAYLOAD_TOO_LARGE413 no The request body is too large. UNSUPPORTED_MEDIA_TYPE415 no The content type is not accepted. RANGE_NOT_SATISFIABLE416 no The requested byte range is invalid or unavailable. UNPROCESSABLE422 no The content was understood but cannot be processed. RATE_LIMITED429 yes Too many requests; wait for Retry-After seconds. INTERNAL500 yes Unexpected server error; retry later. SERVICE_UNAVAILABLE503 yes Temporarily unavailable; retry with backoff.
These answers also carry offers (what fixes it: a trial, a subscription, an upgrade, a pack or
adding a card, each a CHAMPREP Billing link) and, where one allowance or feature is meant, feature.
Code HTTP Retryable Meaning RTC_SUBSCRIPTION_REQUIRED402 no The account has no RTC subscription, trial or included allowance (see offers). RTC_PAYMENT_REQUIRED402 no An unpaid invoice blocks RTC; pay it in CHAMPREP Billing. RTC_ACCESS_DENIED403 no An organization, team or platform policy denies RTC (reasonCode says which). RTC_ALLOWANCE_EXHAUSTED402 no An RTC allowance of the subscription is used up (feature says which; see offers). RTC_FEATURE_NOT_IN_PLAN403 no The subscription does not include this feature (see offers). RTC_PLAN_LIMIT403 no A limit of the subscription is reached (room size, rooms open at the same time). PAYMENT_METHOD_REQUIRED402 no The trial needs a saved card on the paying workspace (see offers). TRIAL_ALREADY_USED409 no The free trial was already used by this account. TRIAL_NOT_ALLOWED403 no This account cannot start the free trial. TRIAL_UNAVAILABLE409 no The free trial is not available. ALREADY_SUBSCRIBED409 no The account already has an RTC subscription. PRIMARY_TOKEN_REQUIRED401 no Starting a trial needs the account owner’s console session. PRIMARY_TOKEN_INVALID401 no The console session is not valid for starting a trial; sign in again. PRIMARY_TOKEN_MISMATCH403 no Only the account owner can start this trial.
Code HTTP Retryable Meaning INVALID_CURSOR400 no The cursor is malformed or belongs to another list. IDEMPOTENCY_KEY_INVALID400 no The Idempotency-Key header is malformed. IDEMPOTENCY_KEY_REUSED409 no The Idempotency-Key was used with a different request. IDEMPOTENCY_IN_PROGRESS409 yes The first request with this Idempotency-Key is still running.
Code HTTP Retryable Meaning ROOM_EXTERNAL_REF_CONFLICT409 no An open room of the project already uses this externalRef. ROOM_FULL409 no The room has reached its participant limit. ROOM_LOCKED409 no The room is locked; only hosts can join. ROOM_ALLOWANCE_UNAVAILABLE503 yes The room participant allowance could not be read. PARTICIPANT_BANNED409 no This identity is banned from the room. PARTICIPANT_REMOVED403 no This participant was removed from the room. MEDIA_CAPACITY503 yes No media node has room for this now; retry later. MEDIA_NODE_UNAVAILABLE503 yes The room’s media node is unavailable; retry. MEDIA_UNAVAILABLE503 yes The media service is unavailable; retry. HOST_MUTED403 no A host muted this source. DATA_NOT_PERMITTED403 no The participant may not send app messages. MESSAGE_TOO_LARGE400 no The app message is too large. MESSAGE_RATE_LIMITED429 yes Too many app messages from this participant. ROOM_MESSAGE_RATE_LIMITED429 yes Too many app messages in this room. RESERVED_TOPIC400 no The app message topic is reserved. INVALID_RECIPIENTS400 no The app message recipients are invalid. RESUME_REFUSED403 no The session cannot be resumed. RESUME_UNAVAILABLE503 yes Resume is temporarily unavailable. FIRST_PARTY409 no Reserved for CHAMPREP’s own products. FIRST_PARTY_NOT_READY503 yes The first-party tenant is not provisioned yet.
Code HTTP Retryable Meaning JOIN_GRANT_INVALID401 no The join token is malformed, expired, wrongly signed or its signing key is revoked. JOIN_GRANT_USED409 no This join token was already exchanged (they are single use). SIGNING_KEY_LIMIT409 no The project already has the maximum number of active signing keys. SIGNING_KEY_INVALID400 no The public key is not a valid P-256 JWK.
Code HTTP Retryable Meaning COMPOSITE_UNAVAILABLE400 no Composite recording is not available. DELETE_NOT_AVAILABLE403 no Recordings cannot be deleted by customers (no longer sent: DELETE /v1/recordings/:id sends the recording to Trash, auto-deleted after 30 days). RECORDING_ACTIVE409 no The recording is still running. RECORDING_SETTLING409 yes The recording is still being stored. RECORDING_NOT_READY409 no The recording is not finished yet (deliveries need a ready recording). RECORDING_NOT_IN_TRASH409 no Only a recording in Trash can be deleted permanently; delete it first. RECORDING_PURGED409 no The recording was deleted permanently (from Trash, or by an administrator) and cannot be restored. CONFIRM_PURGE_REQUIRED400 no Shortening the Trash window needs confirmPurge: true. TRANSCRIPTION_UNAVAILABLE400 no Transcripts are not available for this account. TRANSCRIPT_EXISTS409 no A transcript of this recording already exists or is running. NO_AUDIO409 no The recording has no audio to transcribe. TRANSCRIPT_NOT_READY409 yes The transcript is not done yet; only a done transcript exports as VTT, SRT or TXT. TRANSCRIPT_RUNNING409 no The transcript is already being made and cannot be cancelled. TRANSCRIPT_NOT_CANCELLABLE409 no Only a transcript that has not started can be cancelled. WINDOW_TOO_LONG400 no The requested time window is too long. SUMMARY_TIMEOUT503 yes The summary took too long; retry. CAPTIONS_BUSY503 yes Live captions are at capacity; retry later. CAPTIONS_LANGUAGE_LIMIT409 no Too many caption languages in this room. CAPTIONS_NOT_PERMITTED403 no The participant may not use captions. INVALID_LANGUAGE400 no The language code is not supported.
Code HTTP Retryable Meaning DESTINATION_LIMIT409 no The organization has the maximum number of storage destinations. DESTINATION_ADMIN_DISABLED403 no CHAMPREP support disabled this storage destination; it cannot be re-enabled by the customer. ENDPOINT_NOT_ALLOWED400 no The S3-compatible endpoint is not allowed (HTTPS on 443 to a public address only). REDELIVERY_LIMIT429 yes The recording was sent again recently, or the organization sent too many again this hour; retry later. NO_ACTIVE_DESTINATION409 no No active storage destination applies to this recording. EGRESS_UNAVAILABLE503 yes Billing could not be reached to cover this download; try again shortly. DELIVERY_NOT_CONFIGURED503 no AWS role destinations are not available yet; use S3-compatible keys (code and message are sent). CREDENTIALS_UNAVAILABLE503 no Storing destination keys is not available yet; use an AWS role.
Code HTTP Retryable Meaning WEBHOOK_NOT_CONFIGURED409 no No webhook endpoint is configured. WEBHOOK_URL_INVALID400 no The webhook URL is not a public HTTPS endpoint on port 443 outside CHAMPREP domains. WEBHOOK_ENDPOINT_LIMIT409 no The plan’s number of webhook endpoints is reached (details.limit, details.used). WEBHOOK_ENDPOINT_NOT_FOUND404 no The webhook endpoint does not exist. WEBHOOK_ENDPOINT_DISABLED409 no The webhook endpoint is disabled; enable it first. WEBHOOK_ENDPOINT_ADMIN_DISABLED403 no CHAMPREP support turned the webhook endpoint off; contact support. WEBHOOK_URL_ADMIN_DISABLED403 no CHAMPREP support turned this webhook URL off; it cannot be added again. Contact support. WEBHOOK_EVENT_UNKNOWN400 no An event filter matches no known event type (details.patterns). REPLAY_LIMIT409 no This delivery was replayed too often. REPLAY_QUOTA429 yes Too many replays; wait for Retry-After seconds. DELIVERY_IN_PROGRESS409 yes The delivery is being sent right now.
Code HTTP Retryable Meaning WHITEBOARD_UNAVAILABLE503 yes The whiteboard service is unavailable. WHITEBOARD_DISABLED403 no Whiteboards are turned off for this account. WHITEBOARD_ARCHIVED409 no The whiteboard is archived. WHITEBOARD_LIMIT409 no The room has the maximum number of whiteboards. WHITEBOARD_QUOTA402 no The whiteboard allowance is used up. WHITEBOARD_FILE_INVALID422 no The whiteboard file could not be read. WHITEBOARD_FILE_LIMIT409 no The whiteboard has the maximum number of files. WHITEBOARD_FILE_PENDING409 yes The whiteboard file upload is not finished. WHITEBOARD_FILE_SIZE400 no The declared file size is invalid. WHITEBOARD_FILE_TOO_LARGE413 no The whiteboard file is too large. WHITEBOARD_FILE_TYPE415 no The whiteboard file type is not allowed. SNAPSHOT_TOO_LARGE413 no The whiteboard snapshot is too large to return.
Code HTTP Retryable Meaning RC_BLOCKED403 no Remote control is blocked. RC_CLIPBOARD_OFF403 no Clipboard sharing is off. RC_CLIPBOARD_TOO_LARGE413 no The clipboard content is too large. RC_CONFLICT409 no Another remote control request conflicts. RC_INVALID_REQUEST400 no The remote control request is invalid. RC_NOT_PERMITTED403 no Remote control is not permitted. RC_NO_BUDGET402 no No remote control allowance is left. RC_PENDING409 no A remote control request is already pending. RC_RATE_LIMITED429 yes Too many remote control requests. RC_REAUTH_REQUIRED401 no Re-authenticate to continue remote control. RC_SHARER_BUSY409 no The sharer is already controlled. RC_UNAVAILABLE404 no Remote control is unavailable. RC_WIDEN_REFUSED403 no The remote control grant cannot be widened.
Code HTTP Retryable Meaning INVALID_TELEMETRY400 no The telemetry sample is invalid. TELEMETRY_RATE_LIMITED429 yes Too many telemetry samples.