Skip to content

Delete Resource

Delete a custom resource and its permissions. Default resources cannot be deleted.

Endpoint

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

Method

DELETE

Path Parameters

ParameterTypeRequiredDescription
project_idstringYesUnique ID of the project
resource_idstringYesUnique ID of the resource to delete

Headers

HeaderRequiredDescription
AuthorizationYesBearer access token: Bearer <access_token>

Required Permission

resources:delete

Examples

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

Error Codes

CodeHTTP StatusDescription
invalid_params400Invalid or missing request parameters, headers, or body.
invalid_authorization_token401Unauthorized request. The authorization token is missing or invalid.
insufficient_permission403Insufficient permissions to access this resource.
project_not_found404The requested project could not be found.
resource_not_found404The requested resource could not be found.
system_error500An unexpected error occurred. Please try again later.