Skip to main content
POST
Let an OAuth client write for you here

Authorizations

apsio_session
string
cookie
required

The console session, set by /v1/auth/callback (__Host-apsio_session when host-only).

Path Parameters

orgId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"0192f3a4-0000-7000-8000-00000000a001"

Body

application/json
client_id
string
required
Required string length: 1 - 256
capability
enum<string>
required

What the client may do: dashboards:write (create and edit dashboards) or issues:write (change issue states and assignees).

Available options:
dashboards:write,
issues:write
client_name
string
Maximum string length: 100

Response

201 - application/json

The grant

id
string
required
org_id
string
required
user_id
string
required
user_name
string
required
client_id
string
required

The OAuth client's id, as the access token names it (a URL for clients registered by a Client ID Metadata Document). Untrusted text: show it as text, never as a link.

client_name
string
required

The name the user gave the client.

capability
enum<string>
required

What the client may do: dashboards:write (create and edit dashboards) or issues:write (change issue states and assignees).

Available options:
dashboards:write,
issues:write
created_at
string
required
last_used_at
string | null
required
expires_at
string
required

Unless used before: 90 days after the last use (or the grant).