Skip to content
RelationsAI
Error codes

legacy_api_key_not_supported

HTTP status
401
Retry
No
Execution
Nothing was done
Admin needed
Yes

Legacy API key not supported. Keys that begin sk_live_ predate scopes and test mode. They keep working where they worked before, but the v1 API accepts only scoped keys (rai_test_ and rai_live_).

What it means

The API returns HTTP 401 with error.code set to legacy_api_key_not_supported. The default message is: "Legacy API keys cannot be used with the v1 API. Create a scoped key in the console."

Common causes

  • An sk_live_ key was sent to the v1 API.

How to identify it

Check the response status (401) and error.code (legacy_api_key_not_supported). Branch on error.code, not on the message text: messages can be reworded, codes do not change within v1. Log error.request_id (also sent as the X-Request-Id header) so support can find the request.

How to fix it

  • Create a scoped key in the console under API & Developers and use it instead.

Retry guidance

Sending the request unchanged fails the same way. Fix the cause first (see How to fix it), then send it again.

Did anything happen?

This request was refused before any call was placed and before anything was charged.

Idempotency

Nothing was done and nothing was stored (under an Idempotency-Key, if you sent one), so the request can be sent again, with the same key if you used one, once the cause is fixed.

Who can fix it

A workspace administrator usually has to act, in the RelationsAI console.

When to contact support

If the error persists after the steps above, contact support@relationsai.com. See Support for what to include (the request_id, the time in UTC, the operation, and whether you used a test or live key) and what never to send (API keys, Authorization headers, webhook signing secrets, recording links, transcripts or customer data).

Example error response

JSONJSON
{
  "error": {
    "code": "legacy_api_key_not_supported",
    "message": "Legacy API keys cannot be used with the v1 API. Create a scoped key in the console.",
    "details": {},
    "request_id": "req_t4lwuuscjdazkytra2fdu4kp",
    "retry": "no",
    "doc_url": "https://docs.relationsai.com/errors/legacy_api_key_not_supported"
  }
}

See all codes in the error-code reference.

invalid_api_keycampaign_budget_reached