v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Access Request API

List Requestable Roles

List roles that are available for requesting access. Returns roles with their access policy IDs so callers can look up policy constraints (max duration, justification requirements) via the Access Policy API.

get/v2/requestable-roles

Query parameters

teamIdstring required

The ID of the team. Required.

The ID of the team. Required.

targetUserIdstring

The ID of the user to check requestable roles for. Defaults to the authenticated user if omitted.

The ID of the user to check requestable roles for. Defaults to the authenticated user if omitted.

pageSizeinteger

Maximum number of results to return. Default is 100, maximum is 1000.

Maximum number of results to return. Default is 100, maximum is 1000.

pageTokenstring

Token for pagination. Leave empty for the first request.

Token for pagination. Leave empty for the first request.

Response

Success

nextPageTokenstring nullable

Token for retrieving the next page of results. Empty if no more results.