Sign in
API Keys

Rotate API Key

Rotates the API key's secret, invalidating the previous secret immediately. The response is the only place the new secret_key is returned.

post/api_keys/{id}/rotate

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Response

api key rotated

api_version_date'2025-01-01' | '2026-06-08' | '2026-06-09' | '2026-06-20' | '2026-07-01' | '2026-07-08' | '2026-07-08-1' | '2026-07-18' | '2026-07-20' | '2026-07-22' | '2026-07-23' | '2026-07-25' | '2026-07-26' | '2026-07-27' | '2026-07-29' | '2026-07-29-1' | '2026-07-31' | '2026-08-03' | '2026-08-05' | '2026-08-05-1' | '2026-08-10' | '2026-08-12' | '2026-08-13' | '2026-08-14' | '2026-08-21' | '2026-08-21-1' | '2026-08-25' | '2026-08-25-1' | '2026-08-25-2' | '2026-08-31' | '2026-09-02' | '2026-09-02-1' | '2026-09-02-2' | '2026-09-04' | '2026-09-06' | '2026-09-09' | '2026-09-09-1' | '2026-09-11' | '2026-09-11-1' | '2026-09-13' | '2026-09-15' | '2026-09-22' | '2026-09-22-1' | '2026-09-22-2' | '2026-09-22-3' | '2026-09-22-4' | '2026-09-23' | '2026-09-24' | '2026-09-24-1' | '2026-09-25' required

Dated API version used when requests authenticated with this key omit the Api-Version-Date header.

created_atstring required

When the API key was created, as an ISO 8601 timestamp.

expires_atstring nullable required

When the API key stops working, as an ISO 8601 timestamp. null means it never expires.

idstring required

API key ID, prefixed apik_.

ip_allowliststring[] nullable required
is_default_for_resourceboolean required

Whether this is the resource's default API key. Default keys cannot be updated or deleted, only rotated.

namestring nullable required

Human-readable name identifying the API key, or null when none was set.

obfuscated_secret_keystring required

Masked version of the secret key, so the key can be recognized without revealing the full secret.

secret_keystring

The full secret used to authenticate requests. Returned only once, on create and rotate responses — store it immediately.

system_role'owner' | 'admin' | 'moderator' | 'sales_manager' | 'advertiser' | 'null' nullable required

System role the key inherits its permissions from, or null when it uses an explicit permissions policy. Only account API keys can use a system role.

updated_atstring required

When the API key was last updated, as an ISO 8601 timestamp.

Example response

{
  "api_version_date": "2026-09-25",
  "created_at": "2026-01-01T12:00:00.000Z",
  "expires_at": "2026-01-01T12:00:00.000Z",
  "grants": [
    {
      "actions": [
        {
          "action": "ai_prompt:create"
        }
      ],
      "resource_id": "biz_xxxxxxxxxxxxxx",
      "resource_type": "account"
    }
  ],
  "id": "apik_xxxxxxxxxxxxxx",
  "ip_allowlist": [
    "203.0.113.0/24"
  ],
  "name": "Shine Time Booking (admin role)",
  "obfuscated_secret_key": "apik_xxxx....xxxx",
  "secret_key": "apik_xxxxxxxxxxxxxx_C0000_C_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "system_role": "admin",
  "updated_at": "2026-01-01T12:00:00.000Z"
}

Changes

Changed in 24 of the 74 revisions of this API.296

  • 86b97292852d2See the full diff
    • ●

      added the new 2026-09-24-1 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new 2026-09-25 enum value to the response property for the response status

      response-property-enum-value-added

  • c1dceb26e5051See the full diff
    • ●

      added the new 2026-09-24 enum value to the response property for the response status

      response-property-enum-value-added

  • 7fcefabddb0a1See the full diff
    • ●

      added the new 2026-09-23 enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 140d015b99665See the full diff
    • ●

      added the new 2026-09-22 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new 2026-09-22-1 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new 2026-09-22-2 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new 2026-09-22-3 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new 2026-09-22-4 enum value to the response property for the response status

      response-property-enum-value-added

  • ff3a765735631See the full diff
    • ●

      added the new 2026-09-15 enum value to the response property for the response status

      response-property-enum-value-added

  • c19acf2e25481See the full diff
    • ●

      added the new 2026-09-13 enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1660b8d622041See the full diff
    • ●

      added the new 2026-09-11-1 enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 918ff9d965e12See the full diff
    • ●

      added the new 2026-09-09-1 enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new 2026-09-11 enum value to the response property for the response status

      response-property-enum-value-added

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 2a25564a92d51See the full diff
    • ●

      added the new 2026-09-09 enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 4fe3b2d215461See the full diff
    • ●

      added the new 2026-09-06 enum value to the response property for the response status

      response-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.