Skip to main content
POST
/
api
/
v1
/
policies
/
associations
Create Policy Association
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/policies/associations \
  --header 'Content-Type: application/json' \
  --data '{
  "policy_id": "<string>",
  "policy_name": "<string>",
  "entity_type": "agent",
  "entity_id": "<string>",
  "enabled": true,
  "priority": 123,
  "metadata": {}
}'
{
  "id": "<string>",
  "organization_id": "<string>",
  "policy_id": "<string>",
  "policy_name": "<string>",
  "entity_type": "<string>",
  "entity_id": "<string>",
  "enabled": true,
  "priority": 123,
  "metadata": {},
  "created_at": "<string>",
  "updated_at": "<string>",
  "created_by": "<string>"
}

Body

application/json

Schema for creating a policy association

policy_id
string
required

Policy UUID from enforcer service

policy_name
string
required

Policy name (cached)

entity_type
enum<string>
required

Entity type

Available options:
agent,
team,
environment
entity_id
string
required

Entity UUID

enabled
boolean
default:true

Whether association is active

priority
integer | null

Custom priority (overrides default)

metadata
object

Additional metadata

Response

Successful Response

Response model for policy associations

id
string
required
organization_id
string
required
policy_id
string
required
policy_name
string
required
entity_type
string
required
entity_id
string
required
enabled
boolean
required
priority
integer
required
metadata
object
required
created_at
string
required
updated_at
string
required
created_by
string | null