Skip to content

Delete User

Permanently remove a user from a project.

Endpoint

/api/v1/projects/{project_id}/users/{user_id}

Method

DELETE

Path Parameters

ParameterTypeRequiredDescription
project_idstringYesUnique ID of the project
user_idstringYesUnique ID of the user to delete

Headers

HeaderRequiredDescription
AuthorizationYesBearer access token: Bearer <access_token>

Required Permission

users:delete

Examples

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

Error Codes

CodeHTTP StatusDescription
invalid_params400Missing or invalid request params, headers, or body
invalid_authorization_token401Missing or invalid authorization token
insufficient_permission403Insufficient permission
project_not_found404Project not found
user_not_found404User not found
system_error500Internal server error