Skip to main content
POST
/
v0
/
keys
curl -X POST https://api.getagentdrive.com/v0/keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI/CD Pipeline",
    "scope": "read-write"
  }'

{
  "id": "key_abc123",
  "key": "agd_sk_live_abcdef1234567890abcdef1234567890",
  "key_prefix": "agd_sk_live_abcd",
  "name": "CI/CD Pipeline",
  "scope": "read-write",
  "created_at": "2026-03-19T10:00:00Z",
  "last_used_at": null
}

​
Request Body

​
name
string
An optional name for the API key to help identify it.
​
scope
string
The access scope for the key. Either "read-write" or "read-only". Defaults to "read-write".
curl -X POST https://api.getagentdrive.com/v0/keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI/CD Pipeline",
    "scope": "read-write"
  }'

{
  "id": "key_abc123",
  "key": "agd_sk_live_abcdef1234567890abcdef1234567890",
  "key_prefix": "agd_sk_live_abcd",
  "name": "CI/CD Pipeline",
  "scope": "read-write",
  "created_at": "2026-03-19T10:00:00Z",
  "last_used_at": null
}
The full API key (key field) is only returned once at creation time. Store it securely — you will not be able to retrieve it again.

​
Response

​
id
string
Unique identifier for the API key.
​
key
string
The full API key. Only returned at creation time.
​
key_prefix
string
A prefix of the key for identification purposes.
​
name
string
The name of the API key.
​
scope
string
The access scope: "read-write" or "read-only".
​
created_at
string
ISO 8601 timestamp of when the key was created.
​
last_used_at
string
ISO 8601 timestamp of when the key was last used, or null.