Skip to main content
POST
Request a key by approval link

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required

The key name shown in Settings and on the approval page.

Required string length: 1 - 80
scopes
enum<string>[]
required
Minimum array length: 1
Available options:
datalyr:read,
datalyr:write:rules,
datalyr:write:links,
datalyr:propose:scripts
expires_in
integer | null

Seconds the minted key lives. 1 to 365 days. Omit it for a key that does not expire.

Required range: 86400 <= x <= 31536000
workspace_id
string

Required with an OAuth access token. Ignored otherwise, because the credential names the workspace.

Response

Created. Nothing is minted until a person approves.

request_id
string<uuid>
required
approval_url
string<uri>
required

Give this to a person in the workspace. Single-use. The token after # is the credential, so treat the whole URL as a secret.

poll_url
string<uri>
required
expires_at
string<date-time>
required

The request expires 24 hours after creation.

status
enum<string>
required
Available options:
pending