v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB

Access Request API

Create Access Request

Create an access request for a role. The request will go through the configured approval flow before access is provisioned.

post/v2/access-requests

teamIdstring required

The ID of the team. Required.

roleIdstring required

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

targetUserIdstring nullable

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

accessMinutesinteger

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

businessJustificationstring nullable

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

scheduledStartAtstring nullable

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

Success