# AxonFlow Typed Policy Authoring API

**Canonical:** https://apis.io/apis/axonflow/axonflow-typed-policy-authoring-api/  
**Provider:** AxonFlow — https://apis.io/providers/axonflow/  
**Base URL:** http://localhost:8080  
**Documentation:** https://docs.getaxonflow.com/docs/orchestration/api-reference/

AxonFlow Typed Policy Authoring API is one of 54 APIs that [AxonFlow](https://apis.io/providers/axonflow/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 24 JSON Schema definitions. Tagged areas include Typed Policy Authoring. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 24 JSON Schemas.

The ADR-065 typed policy authoring surface, available on EVERY edition (#3907). It is the write path a deployment without the Enterprise customer portal uses, and the portal is one client of the same library rather than the only way in. What an edition may express is bounded by CONSTRUCTS - scope kinds, the request-context attribute namespaces, obligation families - and not by the signing root: every customer-authored policy on every edition is organization-root. `GET /api/v1/typed-policies/edition` reports this deployment's boundary and its document ceiling, so a caller can read the limits rather than discover them one refusal at a time. The organization and the author are taken from the `X-Org-ID` and `X-User-ID` headers the agent gateway stamps, never from the request body: the author is carried inside the signed policy source. No endpoint in this family accepts an organization anywhere. **The Enterprise customer portal serves some of these same paths with a DIFFERENT handler**, and this document describes the orchestrator's. The portal's `/api/v1/typed-policies/*` surface is behind a portal session and `policy:write`, takes an explicit approver list resolved against the organization's directory, and carries editor affordances (catalog, schema, diff, artifacts, rollback) this surface does not. A caller reaches one or the other by which service it addresses, never by a field in the request. The two share the library, the vocabulary and the document format; they do not share this specification.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/typed-policies/edition` | What this deployment may author |
| POST | `/api/v1/typed-policies/validate` | Validate a candidate document |
| POST | `/api/v1/typed-policies/publish` | Publish a document as a signed artifact |
| POST | `/api/v1/typed-policies/activate` | Activate a published digest |
| GET | `/api/v1/typed-policies/active` | The document currently in force |
| GET | `/api/v1/typed-policies/active/summary` | How many policies are in force on this organization, and whose |
| GET | `/api/v1/typed-policies/template` | The shipped organization template, read-only |
| GET | `/api/v1/typed-policies/system` | The platform's own controls, read-only |

## Machine-readable artifacts (26)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/openapi/axonflow-typed-policy-authoring-api-openapi.yml
- **Documentation** — https://docs.getaxonflow.com/docs/orchestration/api-reference/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-decide-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-mcpcheck-input-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-pre-check-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-client-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-decide-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-mcpcheck-output-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-audit-log-entry-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-step-gate-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-ojkaudit-export-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-approval-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-audit-action-report-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-policy-evaluation-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-simulate-policies-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-create-policy-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-update-policy-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-impact-report-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-apply-template-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-test-policy-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-featassessment-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-aisystem-registry-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-create-registry-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-update-assessment-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-kill-switch-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/axonflow/refs/heads/main/json-schema/axonflow-update-registry-request-schema.json

## Other AxonFlow APIs (12)

- [AxonFlow Agents API](https://apis.io/apis/axonflow/axonflow-agents-api/)
- [AxonFlow Assessments API](https://apis.io/apis/axonflow/axonflow-assessments-api/)
- [AxonFlow Audit API](https://apis.io/apis/axonflow/axonflow-audit-api/)
- [AxonFlow Audit Verification API](https://apis.io/apis/axonflow/axonflow-audit-verification-api/)
- [AxonFlow Bulk Operations API](https://apis.io/apis/axonflow/axonflow-bulk-operations-api/)
- [AxonFlow Circuit Breaker API](https://apis.io/apis/axonflow/axonflow-circuit-breaker-api/)
- [AxonFlow Community SaaS API](https://apis.io/apis/axonflow/axonflow-community-saas-api/)
- [AxonFlow Compliance API](https://apis.io/apis/axonflow/axonflow-compliance-api/)
- [AxonFlow Connectors API](https://apis.io/apis/axonflow/axonflow-connectors-api/)
- [AxonFlow Cost Controls API](https://apis.io/apis/axonflow/axonflow-cost-controls-api/)
- [AxonFlow Cost Management API](https://apis.io/apis/axonflow/axonflow-cost-management-api/)
- [AxonFlow Decision & Execution Replay API](https://apis.io/apis/axonflow/axonflow-decision-execution-replay-api/)

## Tags

Typed Policy Authoring

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/axonflow/axonflow-typed-policy-authoring-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/axonflow/.