Skip to main content
POST
/
api
/
v1
/
policies
/
check-authorization
/
{entity_type}
/
{entity_id}
Check Entity Authorization
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/policies/check-authorization/{entity_type}/{entity_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "resource": "<string>",
  "context": {}
}
'
{
  "authorized": true,
  "violations": [
    "<string>"
  ],
  "policies_evaluated": 123
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Path Parameters

​
entity_type
enum<string>
required
Available options:
agent,
team,
environment
​
entity_id
string
required

Body

application/json

Request model for authorization check

​
action
string
required

Action to check

​
resource
string | null

Resource identifier

​
context
Context · object

Additional context

Response

Successful Response

Response model for authorization check

​
authorized
boolean
required
​
violations
string[]
required
​
policies_evaluated
integer
required