Skip to main content
POST
Create Access Request

Authorizations

Authorization
string
header
required

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

Body

application/json
teamId
string
required

The ID of the team. Required.

roleId
string
required

The ID of the role (entitlement) to request access for. Required.

targetUserId
string | null

The ID of the user to request access for. Defaults to the authenticated user if omitted.

accessMinutes
integer<int32>

The duration of access in minutes. Must not exceed the role's max_access_minutes. Required unless the role has no maximum duration.

businessJustification
string | null

A business justification for the access request. Required if the role's access policy requires justification.

scheduledStartAt
string | null

An optional scheduled start time for provisioning (RFC3339 format). If omitted, access is provisioned immediately upon approval.

Response

Success

data
data · object

The created access request.