API Keys

Create API key

Create a new API key (session auth required). The full key is only returned once!

post/api/api-keys

Request

Base URL: http://dobby-ai.com
URL: http://dobby-ai.com/api/api-keys
Auth: HTTP bearer

Request body

namestring required

Friendly name for the API key

scopesstring[] required

Permission scopes

expires_atstring date-time

Optional expiration date

rate_limitinteger

Custom rate limit (requests/minute)

Example request

{
  "name": "Production Integration",
  "scopes": [
    "tasks:read",
    "tasks:write",
    "agents:read"
  ]
}

Response

API key created

successboolean

secretstring

Full API key secret - only shown once!

Example response

{
  "success": true,
  "key": {
    "key_id": "key_abc123",
    "name": "Production Integration",
    "key_prefix": "sk_live_abc1...",
    "scopes": [
      "tasks:read",
      "agents:read"
    ],
    "is_active": true,
    "rate_limit": 100
  },
  "secret": "dby_k_abc123xyz..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.