Create a policy draft

POST /v1/organization/policies

Create a policy draft

cURL

curl --request POST \
  --url https://api.abliteration.ai/v1/organization/policies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "<string>",
  "rule": "<string>",
  "description": "",
  "mode": "monitoring",
  "project_ids": [
    "<string>"
  ],
  "match_threshold_basis_points": 5000
}
'

201

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "state": "draft",
  "revision": 123,
  "has_unpublished_changes": true,
  "created_at": 123,
  "updated_at": 123,
  "draft": {
    "rule": "<string>",
    "direction": "request",
    "mode": "monitoring",
    "scope": "organization",
    "project_ids": [
      "<string>"
    ],
    "match_threshold_basis_points": 123,
    "base_version": 123
  },
  "object": "organization.policy",
  "current_version": 123,
  "published": {
    "id": "<string>",
    "version": 123,
    "direction": "request",
    "mode": "monitoring",
    "scope": "organization",
    "project_ids": [
      "<string>"
    ],
    "published_at": 123,
    "current": true,
    "rule": "<string>",
    "object": "organization.policy.version",
    "match_threshold_basis_points": 123
  }
}

Authorizations

Authorization · string · header · required

Server-side organization-owned Abliteration Admin API key. Never expose this credential in browser code.

Headers

Idempotency-Key · string · required

Client-generated key used to safely retry this mutation.

Required string length: 8 - 200

Body

application/json

name · string · required

Required string length: 1 - 80

rule · string · required

Required string length: 1 - 20000

direction · enum<string> · required

Available options: request, response, both

scope · enum<string> · required

Available options: organization, projects, unattached

description · string · default: ""

Maximum string length: 240

mode · enum<string> · default: monitoring

Available options: monitoring, enforcing

project_ids · string[]

Maximum array length: 1000

match_threshold_basis_points · integer | null

Required range: 1 <= x <= 9999

Response

201

application/json

Successful Response

id · string · required

name · string · required

description · string · required

state · enum<string> · required

Available options: draft, monitoring, enforcing, paused

revision · integer · required

has_unpublished_changes · boolean · required

created_at · integer · required

updated_at · integer · required

draft · AdministrationPolicyDraft · object · required

Show child attributes

object · string · default: organization.policy

Allowed value: "organization.policy"

current_version · integer | null

published · AdministrationPolicyVersion · object | null

Show child attributes