Skip to main content
POST
Create API key

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Body

application/json
name
string
required

Human-readable name to identify this API key

Maximum string length: 200
expiresAt
string<date-time> | null

Optional expiration timestamp in ISO 8601 format

preset
string | null

Preset expanded into scopes: ci-pr, ci-deploy, agent-responder, agent-author

scopes
string[] | null

Scopes to grant (default: full)

Scopes to grant (default: full)

tool
enum<string> | null

Tool this key writes as on owner-enforced monitors (default: API; CLI = GIT until 2027-01-31)

Available options:
DASHBOARD,
CLI,
TERRAFORM,
MCP,
API,
GIT

Response

Created

data
object
required

Created API key with the full key value — store it now, it won't be shown again