Skip to main content
GET
/
v2
/
app-resource-roles
List App Resource Roles
curl --request GET \
  --url https://public.api.serval.com/v2/app-resource-roles \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "resourceId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "requestsEnabled": true,
      "accessPolicyId": "<string>",
      "provisioningMethod": {
        "builtinWorkflow": {}
      },
      "externalId": "<string>",
      "externalData": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
teamId
string

Filter by team ID. At least one of team_id, app_instance_id, or resource_id must be provided.

​
appInstanceId
string

Filter by app instance ID. At least one of team_id, app_instance_id, or resource_id must be provided.

​
resourceId
string

Filter by resource ID. At least one of team_id, app_instance_id, or resource_id must be provided.

​
pageSize
integer<int32>

Maximum number of results to return. Default is 10000, maximum is 10000.

​
pageToken
string

Token for pagination. Leave empty for the first request.

Response

Success

​
data
Role · object[]

The list of roles.

​
nextPageToken
string | null

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