Skip to content

List Resources

Get a paginated list of resources with their associated permissions defined in a project.

Endpoint

/api/v1/projects/{project_id}/resources

Method

GET

Path Parameters

ParameterTypeRequiredDescription
project_idstringYesUnique ID of the project

Headers

HeaderRequiredDescription
AuthorizationYesBearer access token: Bearer <access_token>

Query Parameters

ParameterTypeRequiredDescription
page_numintegerNoPage number (default: 1)
page_sizeintegerNoResults per page (default: 10)
searchstringNoSearch keyword for resource or permission name, code, and description
is_defaultbooleanNoFilter by default system resource status

Required Permission

resources:read

Examples

curl --request GET \
  --url https://auth.roled.id/api/v1/projects/2JUSLUee46xG6iEwG8JwPc/resources \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJo...'

Error Codes

CodeHTTP StatusDescription
invalid_authorization_token401Missing or invalid authorization token
insufficient_permission403Insufficient permission
project_not_found404Project not found
system_error500Internal server error