Skip to main content
POST
Mark an API key copied
A connect key is then yours: it is listed, and a newer connect key never revokes it to make room. Only the first mark changes the key: a connect key then lives 90 days from it, never less than it had. A key that has expired or been revoked is not found.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: any signed-in member, for their own records; an API key also needs api_keys:manage.
  • Effect: Creates or changes something.
  • Errors: not_found, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

an API key ID: key_ and 32 lowercase hex digits

Example:

"key_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

Response

The key, now listed

id
string
required

an API key ID: key_ and 32 lowercase hex digits

Example:

"key_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

name
string
required
Example:

"Nightly price check"

permissions
enum<string>[]
required
Available options:
tools:read,
usage:read,
tools:build,
runs:create,
jobs:read,
jobs:cancel,
logins:read,
logins:manage,
api_keys:manage,
billing:manage,
team:manage
Example:
integration_id
string | null
required

The one integration the key is bound to, or null for an account key

Example:

"int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

prefix
string
required

The token's visible start, pom_ and 8 hex digits, to tell keys apart

Example:

"pom_0f8e2d1c"

created_via
enum<string>
required

Where the key was created

Available options:
dashboard,
api,
mcp
created_at
string<date-time>
required

An ISO 8601 timestamp in UTC

Example:

"2026-10-05T18:30:00.000Z"

expires_at
string<date-time>
required

An ISO 8601 timestamp in UTC

Example:

"2026-10-05T18:30:00.000Z"

last_used_at
string<date-time> | null
required

When a request last used the key, to within a minute, or null if none has

Example:

"2026-10-05T18:30:00.000Z"

purpose
enum<string> | null
required

connect for a key the Connect page made, else null

Available options:
connect