Create Policy

Create a new OPA policy in the enforcer service.

The policy will be stored in the enforcer service and can then be associated with entities (agents, teams, environments).

POST /api/v1/policies

Create Policy

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/policies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "policy_content": "<string>",
  "description": "<string>",
  "enabled": true,
  "tags": [
    "<string>"
  ],
  "metadata": {}
}
'

201

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "organization_id": "<string>",
  "enabled": true,
  "tags": [
    "<string>"
  ],
  "version": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "policy_content": "",
  "created_by": "<string>",
  "updated_by": "<string>",
  "policy_type": "rego",
  "association_count": 0
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Schema for creating a new policy

name · string · required

Required string length: 1 - 255

policy_content · string · required

Minimum string length: 1

description · string | null

enabled · boolean · default: true

tags · string[]

metadata · Metadata · object

Response

201

application/json

Successful Response

Extended policy response with association count

id · string · required

name · string · required

description · string | null · required

organization_id · string · required

enabled · boolean · required

tags · string[] · required

version · integer · required

created_at · string | null · required

updated_at · string | null · required

policy_content · string | null · default: ""

created_by · string | null

updated_by · string | null

policy_type · string · default: rego

association_count · integer · default: 0