Skip to main content
POST
/
governance
/
permissions
/
revoke
Revoke permission from user or group
curl --request POST \
  --url https://api.example.com/governance/permissions/revoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_or_group": "<string>",
  "relation": "<string>",
  "resource_type": "<string>",
  "resource_id": "<string>",
  "is_group": false
}
'
{
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Request to revoke a permission from a user or group.

​
user_or_group
string
required

User ID or group ID (without prefix)

Examples:

"alice@example.com"

"org-admins"

​
relation
string
required

Relation to revoke (e.g., 'owner', 'admin', 'viewer')

Examples:

"owner"

"admin"

"developer"

​
resource_type
string
required

Type of resource (e.g., 'project', 'artifact', 'secret')

Examples:

"project"

"artifact"

"secret"

​
resource_id
string
required

ID of the resource

Examples:

"my-project"

"artifact-123"

"artifact-123/api-key"

​
is_group
boolean
default:false

Whether the subject is a group (default: False)

Response

Successful Response

Success response for permission operations.

​
message
string
required

Success message