NOnovabilling
Tenants

Create a new API key

Changed on

Generate a new API key with specified scopes. The full key is returned only once in the response — store it securely.

post/api/tenants/me/api-keys

Request

Request body

namestring required
scopesstring[] required
expiresAtstring

Example request

{
  "name": "Production API Key",
  "scopes": [
    "read",
    "write"
  ]
}

Response

API key created. The key value is shown only once.

idstring required
keystring required
namestring required
scopesstring[] required
lastUsedstring
expiresAtstring
createdAtstring required

Example response

{
  "id": "clx1234567890",
  "key": "sk_live_abc123...",
  "name": "Production API Key",
  "scopes": [
    "read",
    "write"
  ]
}

Changes

  • 0e449a4e0dc8Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      added the required property to the response with the status