Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Personal access token for account routes and projects visible to the authenticated user.

Headers

Bisibility-API-Version
enum<string>

API contract version requested by the client. Omit this header to use the current backward-compatible behavior.

Available options:
v1

Body

application/json
name
string
required
Required string length: 1 - 80
expires_in_days
enum<integer> | null
Available options:
30,
90,
365,
null
scope
enum<string>
default:read
Available options:
admin,
read,
write

Response

Created

created_at
string<date-time>
required
expires_at
string<date-time> | null
required
id
string
required
Pattern: ^pat_[a-z][a-z0-9]{23}$
Example:

"pat_a00000000000000000000000"

last_used_at
string<date-time> | null
required
name
string
required
prefix
string
required
Example:

"bsb_pat_live_xxxxxxxx"

revoked_at
string<date-time> | null
required
scope
enum<string>
required
Available options:
admin,
read,
write
masked_value
string
required
token
string
required
Example:

"bsb_pat_live_..."