> ## Documentation Index > Fetch the complete documentation index at: https://docs.serval.com/llms.txt > Use this file to discover all available pages before exploring further. # List App Resource Roles > List all app resource roles for a team, optionally filtered by resource. ## OpenAPI ````yaml /sections/api-reference/openapi-spec-v2.yaml get /v2/app-resource-roles openapi: 3.1.0 info: title: Serval Public API description: Serval Public API contact: name: Serval url: https://serval.com email: support@serval.com license: name: Serval License url: https://serval.com/license version: 2.0.0 servers: - url: https://public.api.serval.com security: - BearerAuth: [] tags: - name: Access Policy API - name: Access Policy Approval Procedure API - name: Access Profile API - name: Access Relationship API - name: Access Request API - name: Agent Session API - name: App Instance API - name: App Resource API - name: App Resource Role API - name: Approval Delegation API - name: Approval Request API - name: Audit Log API - name: Change Blackout API - name: Change Model API - name: Custom Field API - name: Custom Service API - name: Entity API - name: Entity Field Mapping API - name: Entity Ingestion Config API - name: Entity Type API - name: Group API - name: Guidance API - name: Help Agent API - name: Journey API - name: Knowledge API - name: Knowledge Base API - name: Report API - name: SLA API - name: Schedule API - name: Tag API - name: Team API - name: Team User API - name: Ticket API - name: Topic API - name: User API - name: User Relationship API - name: Workflow API - name: Workflow Approval Procedure API - name: Workflow Run API paths: /v2/app-resource-roles: get: tags: - App Resource Role API summary: List App Resource Roles description: List all app resource roles for a team, optionally filtered by resource. operationId: svrelay.publicv2.PublicAPIServiceV2.ListAppResourceRoles parameters: - name: teamId in: query description: >- Filter by team ID. At least one of team_id, app_instance_id, or resource_id must be provided. schema: type: string title: team_id description: >- Filter by team ID. At least one of team_id, app_instance_id, or resource_id must be provided. - name: appInstanceId in: query description: >- Filter by app instance ID. At least one of team_id, app_instance_id, or resource_id must be provided. schema: type: string title: app_instance_id description: >- Filter by app instance ID. At least one of team_id, app_instance_id, or resource_id must be provided. - name: resourceId in: query description: >- Filter by resource ID. At least one of team_id, app_instance_id, or resource_id must be provided. schema: type: string title: resource_id description: >- Filter by resource ID. At least one of team_id, app_instance_id, or resource_id must be provided. - name: pageSize in: query description: >- Maximum number of results to return. Default is 10000, maximum is 10000. schema: type: integer title: page_size format: int32 description: >- Maximum number of results to return. Default is 10000, maximum is 10000. - name: pageToken in: query description: Token for pagination. Leave empty for the first request. schema: type: string title: page_token description: Token for pagination. Leave empty for the first request. responses: '200': description: Success content: application/json: schema: $ref: >- #/components/schemas/svflow.publicapi.ListAppResourceRolesResponse default: description: Error content: application/json: schema: $ref: '#/components/schemas/connect.error' security: - BearerAuth: [] components: schemas: svflow.publicapi.ListAppResourceRolesResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/svflow.pubapimodels.Role' title: data description: The list of roles. x-stainless-terraform-configurability: optional nextPageToken: type: string title: next_page_token description: >- Token for retrieving the next page of results. Empty if no more results. nullable: true x-stainless-terraform-configurability: optional title: ListAppResourceRolesResponse additionalProperties: false connect.error: type: object properties: code: type: string examples: - not_found enum: - canceled - unknown - invalid_argument - deadline_exceeded - not_found - already_exists - permission_denied - resource_exhausted - failed_precondition - aborted - out_of_range - unimplemented - internal - unavailable - data_loss - unauthenticated description: >- The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. x-stainless-terraform-configurability: optional message: type: string description: >- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. x-stainless-terraform-configurability: optional detail: $ref: '#/components/schemas/google.protobuf.Any' x-stainless-terraform-configurability: optional title: Connect Error additionalProperties: true description: >- Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation svflow.pubapimodels.Role: type: object properties: id: type: string title: id description: The ID of the role. readOnly: true x-stainless-terraform-configurability: computed resourceId: type: string title: resource_id description: The ID of the resource that the role belongs to. x-stainless-terraform-configurability: optional name: type: string title: name description: The name of the role. x-stainless-terraform-configurability: optional description: type: string title: description description: A description of the role. x-stainless-terraform-configurability: optional requestsEnabled: type: boolean title: requests_enabled description: Whether requests are enabled for the role. x-stainless-terraform-configurability: computed_optional accessPolicyId: type: string title: access_policy_id description: The default access policy for the role. nullable: true x-stainless-terraform-configurability: optional provisioningMethod: $ref: '#/components/schemas/svflow.pubapimodels.RoleProvisioningMethod' title: provisioning_method description: Provisioning configuration. **Exactly one method should be set.** x-stainless-terraform-configurability: optional externalId: type: string title: external_id description: The external ID of the role in the external system (optional). nullable: true x-stainless-terraform-configurability: optional externalData: type: string title: external_data description: Data from the external system as a JSON string (computed by server). nullable: true readOnly: true x-stainless-terraform-configurability: computed requireFormConfirmation: type: boolean title: require_form_confirmation x-stainless-terraform-configurability: computed_optional tagIds: type: array items: type: string title: tag_ids description: IDs of the tags currently attached to this role. x-stainless-terraform-configurability: optional title: Role additionalProperties: false description: Role represents a requestable role on an app resource. google.protobuf.Any: type: object properties: type: type: string x-stainless-terraform-configurability: optional value: type: string format: binary x-stainless-terraform-configurability: optional debug: type: object additionalProperties: true x-stainless-terraform-configurability: optional additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. svflow.pubapimodels.RoleProvisioningMethod: type: object oneOf: - $ref: >- #/components/schemas/svflow.pubapimodels.RoleProvisioningMethod.BuiltinWorkflow - $ref: >- #/components/schemas/svflow.pubapimodels.RoleProvisioningMethod.CustomWorkflow - $ref: >- #/components/schemas/svflow.pubapimodels.RoleProvisioningMethod.LinkedRoles - $ref: >- #/components/schemas/svflow.pubapimodels.RoleProvisioningMethod.Manual title: RoleProvisioningMethod description: |- Provisioning configuration for a role. Exactly one method should be set. svflow.pubapimodels.RoleProvisioningMethod.BuiltinWorkflow: type: object title: Builtin Workflow properties: builtinWorkflow: $ref: '#/components/schemas/svflow.pubapimodels.BuiltinWorkflowProvisioning' title: builtin_workflow x-stainless-terraform-configurability: optional required: - builtinWorkflow additionalProperties: false svflow.pubapimodels.RoleProvisioningMethod.CustomWorkflow: type: object title: Custom Workflow properties: customWorkflow: $ref: '#/components/schemas/svflow.pubapimodels.CustomWorkflowProvisioning' title: custom_workflow x-stainless-terraform-configurability: optional required: - customWorkflow additionalProperties: false svflow.pubapimodels.RoleProvisioningMethod.LinkedRoles: type: object title: Linked Roles properties: linkedRoles: $ref: '#/components/schemas/svflow.pubapimodels.LinkedRolesProvisioning' title: linked_roles x-stainless-terraform-configurability: optional required: - linkedRoles additionalProperties: false svflow.pubapimodels.RoleProvisioningMethod.Manual: type: object title: Manual properties: manual: $ref: '#/components/schemas/svflow.pubapimodels.ManualProvisioning' title: manual x-stainless-terraform-configurability: optional required: - manual additionalProperties: false svflow.pubapimodels.BuiltinWorkflowProvisioning: type: object title: BuiltinWorkflowProvisioning additionalProperties: false description: Provisioning is handled by the service's builtin workflow integration. svflow.pubapimodels.CustomWorkflowProvisioning: type: object properties: provisionWorkflowId: type: string title: provision_workflow_id description: The workflow ID to provision access. x-stainless-terraform-configurability: optional deprovisionWorkflowId: type: string title: deprovision_workflow_id description: The workflow ID to deprovision access. x-stainless-terraform-configurability: optional title: CustomWorkflowProvisioning additionalProperties: false description: Provisioning is handled by custom workflows for provision + deprovision. svflow.pubapimodels.LinkedRolesProvisioning: type: object properties: linkedRoleIds: type: array items: type: string title: linked_role_ids description: The IDs of prerequisite roles. x-stainless-terraform-configurability: optional title: LinkedRolesProvisioning additionalProperties: false description: Provisioning depends on prerequisite roles being provisioned first. svflow.pubapimodels.ManualProvisioning: type: object properties: assignees: type: array items: $ref: >- #/components/schemas/svflow.pubapimodels.ManualProvisioningAssignee title: assignees description: >- Users and groups that should be assigned/notified for manual provisioning. x-stainless-terraform-configurability: optional title: ManualProvisioning additionalProperties: false description: Provisioning is handled manually by assigned users/groups. svflow.pubapimodels.ManualProvisioningAssignee: type: object properties: assigneeId: type: string title: assignee_id description: The ID of the user or group. x-stainless-terraform-configurability: optional assigneeType: $ref: >- #/components/schemas/svflow.pubapimodels.ManualProvisioningAssigneeType title: assignee_type description: The type of assignee. x-stainless-terraform-configurability: optional title: ManualProvisioningAssignee additionalProperties: false svflow.pubapimodels.ManualProvisioningAssigneeType: type: string title: ManualProvisioningAssigneeType enum: - MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED - MANUAL_PROVISIONING_ASSIGNEE_TYPE_USER - MANUAL_PROVISIONING_ASSIGNEE_TYPE_GROUP securitySchemes: BearerAuth: type: http scheme: bearer ````