Keys

Issue a free API key (when signup is enabled)

Public: no authentication required. When the gateway runs with ALLOW_SIGNUP=true, mints a fresh random API key, stores only its digest, and returns the secret once. The credential belongs to an account so rotation preserves files and allowance usage. Issued keys hold every scope except service:operate. Issuance is persistently rate limited per client IP and UTC day.

POST/api/v1/keysTry it
iNote
No auth required — this endpoint is public and needs no Authorization header.

Body

application/json object

Example body
{
  "name": "string"
}

Errors

CodeMeaning
403Signup is disabled on this gateway.
429Daily key issuance cap reached for this client IP.
cURL
curl -X POST https://gateway.kepto.xyz/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
201 · application/json
{
  "apiKey": "string",
  "key": {
    "id": "string",
    "name": "string",
    "prefix": "string",
    "scopes": [
      "account:manage"
    ],
    "createdAt": 0,
    "lastUsedAt": 0,
    "revokedAt": 0,
    "rotatedFrom": "string"
  },
  "freeTierMaxBytes": 0
}