Skip to main content
POST
Create a project token

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"

projectId
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
name
string
required
Required string length: 1 - 100
scopes
enum<string>[]
Maximum array length: 2

A write scope besides reading: dashboards:write (create and edit dashboards, never delete) or issues:write (change issue states and assignees).

Available options:
dashboards:write,
issues:write
days
default:90

How long the token lasts, in days.

Available options:
7

Response

201 - application/json

The token, once

id
string
required

The token's id (its jti); never the token.

project_id
string
required
name
string
required
scopes
enum<string>[]
required

Write scopes; empty: the token only reads.

A write scope besides reading: dashboards:write (create and edit dashboards, never delete) or issues:write (change issue states and assignees).

Available options:
dashboards:write,
issues:write
created_by
string | null
required
created_by_name
string
required

Empty for a token Apsio staff made, or a user since erased.

created_at
string
required
expires_at
string
required
last_used_at
string | null
required

Written at most every 5 minutes.

token
string
required

The token itself (apsio_pt_v0…), shown this once. Keep it as APSIO_TOKEN; Apsio cannot show it again.