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 'Content-Type: application/json' \
  --data '{
  "action": "<string>",
  "resource": "<string>",
  "context": {}
}'
{
  "authorized": true,
  "violations": [
    "<string>"
  ],
  "policies_evaluated": 123
}

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
object | null

Additional context

Response

Successful Response

Response model for authorization check

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