Endpoints

Issue policies

GET/api/v1/issue-policies

Every issue policy in the active org, system- and user-defined alike, name-ordered. Disabled rows are included — a disabled system policy must read as disabled, not as absent (#854 AC).

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Response Body

application/json

curl -X GET "https://example.com/api/v1/issue-policies"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "origin": "system",      "is_enabled": true,      "service_id": "641e839f-864e-4cce-98f9-40f6cbb3e9e0",      "severities": [        "string"      ],      "status_codes": [        "string"      ],      "threshold_occurrences": 0,      "threshold_window_seconds": 0,      "last_applied_config": {}    }  ]}
GET/api/v1/issue-policies/effective

The policy that actually governs service (or the org as a whole, when service is omitted), plus a human-readable reason it won.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

service?|

Service name to resolve for; omitted means org-wide

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/issue-policies/effective"
{  "policy": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "origin": "system",    "is_enabled": true,    "service_id": "641e839f-864e-4cce-98f9-40f6cbb3e9e0",    "severities": [      "string"    ],    "status_codes": [      "string"    ],    "threshold_occurrences": 0,    "threshold_window_seconds": 0,    "last_applied_config": {}  },  "reason": "string"}
GET/api/v1/issue-policies/{policy_id}

One issue policy by id, within the active org — 404 across tenants, matching get_service's own org-scoped natural-key lookup. Declared after /effective so that literal path is matched first.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

policy_id*Policy Id
Formatuuid

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/issue-policies/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "origin": "system",  "is_enabled": true,  "service_id": "641e839f-864e-4cce-98f9-40f6cbb3e9e0",  "severities": [    "string"  ],  "status_codes": [    "string"  ],  "threshold_occurrences": 0,  "threshold_window_seconds": 0,  "last_applied_config": {}}