Skip to main content
POST
/
v1
/
accounts
/
{id}
/
api-keys
Create API Key
curl --request POST \
  --url https://agentdrop-production.up.railway.app/v1/accounts/{id}/api-keys \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "api_key": "<string>",
  "created_at": "<string>"
}

Create API Key

Generate a new API key for your account. Use separate keys for different agents, environments, or team members.
The API key value is returned once in this response. Store it immediately. You cannot retrieve it later.

Request

Headers

Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

Path Parameters

id
string
required
Your account ID. Example: acc_abc123

Body

name
string
required
A descriptive name for this key. Examples: production-agent, staging, crewai-pipeline.

Response

id
string
The key ID, used for revocation.
name
string
The name you assigned to this key.
api_key
string
The full API key. Starts with agd_. Shown once.
created_at
string
ISO 8601 creation timestamp.

Examples

curl -X POST https://agentdrop-production.up.railway.app/v1/accounts/acc_abc123/api-keys \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-agent"}'

Response

{
  "id": "key_xyz789",
  "name": "production-agent",
  "api_key": "agd_live_zzzzzzzzzzzzzzzzzzzz",
  "created_at": "2026-03-22T12:00:00Z"
}

Key Limits by Plan

PlanMax API Keys
Free1
Pro10
EnterpriseUnlimited
Creating a key beyond your plan’s limit returns 403 Forbidden.

Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
403KEY_LIMIT_REACHEDYou’ve reached the API key limit for your plan