Create an API key
Create an API key with a role and optional scopes
scopes optionally restricts it to a subset of the role’s permissions. Scopes are permission keys like connectors.read — each role’s permissions array from GET /v1/orgs/{org_id}/roles lists the valid values.Authorizations
Ardent API key (sk-ard_live_… / sk-ard_test_…) or a dashboard session token.
Path Parameters
Body
Descriptive name for the key
1 - 100Role ID to grant to this API key (e.g., role_org_member)
Days until expiration (null = never expires)
Permission keys like connectors.read, a subset of the role's; empty uses all.
Response
The created key, including the secret — shown only this once.
The full secret key; shown only this once — store it now.
ID of the created key.
When the key was created.
First characters of the key, for identifying it in lists.
Human-readable key name.
ID of the role granted to the key.
The role's stable key, for example role_org_member.
Permission scopes granted to the key.
Reminder that the secret cannot be retrieved again.
When the key expires. Null when it does not expire.