API reference · gate / route / seal / verify / meter

Add a Planisphere gate before the AI action runs.

The API receives a team-owned workflow action, applies the selected vertical pack and tenant policy overlay, then returns an allow, review, or block decision with raw-safe receipt metadata your compliance path can inspect. OpenAPI remains the schema source of truth; this page is the buyer-readable map.

Open the Console See the action gate
01 ·

The API lanes.

gate · route · seal · verify · meter
Gate

Proposed action

The integration asks about the next AI action, not the whole system. The same primitive works for law, defense, medicine, education, and US-regulatory packs.

Policy

Tenant overlay

Teams keep local rules beside out-of-the-box packs: allow lists, hard denies, required review routes, and policy receipt history.

Route

Active Manifest

When work needs review, Planisphere prepares the dispatch record for Slack-shaped, ServiceNow-shaped, webhook, or browser workflows.

Proof

Signed receipt

Production receipts are signed with a managed KMS-held Ed25519 key over raw-safe metadata. Sandbox receipts are clearly marked dev_key:true and use a non-production signer.

Meter

Sealed usage

Each sealed production action records credits from the gate rate and request size, rounded up in estimated 1,000-token blocks. Account state exposes the usage ledger.

02 ·

Endpoint map.

The full documentation lives at api.planisphere.ooo/docs — quickstart, integration guides (SDKs, LangChain, OpenAI Agents, middleware, webhooks), the prove-it-later recipe, and the pack catalog. The interactive OpenAPI (Swagger) reference — the schema source of truth — is at /docs/api. New here? Start with the Read the Docs.

buyer-readable route map · OpenAPI is canonical
Core primitives POST /v1/gate POST /v1/record POST /v1/reviews POST /v1/verify GET /v1/records/{action_key}

Gate a proposed_action before it runs, record a completed duty event, decide a review, and verify any receipt — the pack rides as a request field.

Records at scale GET /tenant/exports/records GET /tenant/exports/records/summary POST /evidence-packets/seal-bundle/batch GET /v1/records/{action_key}/inclusion-proof

Time-range exports with cursors, per-pack coverage counts, batch evidence bundles, and epoch-anchored inclusion proofs.

Policy overlay GET /tenant/policy/options?policy_pack=... POST /tenant/policy/preview?policy_pack=... PUT /tenant/policy?policy_pack=... GET /tenant/policy/receipts?policy_pack=...

Preview and record team-specific rules without storing raw prompt, document, key, or secret material.

Routing GET /active-manifest GET /routing/outbox POST /routing/outbox/process POST /integrations/callbacks/{tenant_id}/{channel}/{target}/review-decision

Expose the live operating board and raw-safe dispatch records for review workflows.

Signed receipt GET /evidence-packets/proof-kit POST /evidence-packets/seal-bundle POST /evidence-packets/verify-seal GET /{vertical}/evidence-packets/{action_key}

Seal an offline-verifiable record and verify the shared seal for every vertical without exposing private signing keys or private engine logic.

Federal exports GET /tenant/exports/oscal GET /tenant/exports/data-catalog GET /tenant/exports/ai-acquisition

Produce machine-readable procurement and compliance read models with validation_profile status and blocking gaps for owner review, not authorization decisions.

Federal validation GET /tenant/exports/validation-schema-manifest POST /tenant/exports/validation-schema-bindings POST /tenant/exports/validation-runs GET /tenant/exports/validation-runs/overview

Bind a schema source, run a local preflight, store a durable hash-only receipt, and route owner review without claiming official OSCAL, catalog, or procurement approval.

Operator setup GET /tenant/integrations/docs-package GET /tenant/integrations/provider-walkthrough GET /tenant/api-keys POST /signup/checkout

Help teams wire keys, routes, callbacks, and provider-native controls without shipping Planisphere IP to the customer.

Usage meter GET /account/me

Read the tenant's sealed-action usage ledger. Production pricing is one cent per credit, capped at $25 per action; sandbox keys include 100 sealed actions.

03 ·

Vertical packs share the chokepoint.

one proposed_action gate, pack-specific defaults
Law

Citation and supervision

/law/proposed-action

Routes filing, citation, privilege, and counsel-supervision work to review instead of treating model output as legal approval.

Defense

Paper trail controls

/defense/proposed-action

Handles controlled-sharing and contract-response workflows with export-control and program-route boundaries.

Medicine

Clinical AI supervision

/medicine/proposed-action

Routes PHI, model-change, clinical-support, and patient-facing work toward owner review and evidence exports.

Education

Student AI supervision

/education/proposed-action

Protects student-data and scoring-review workflows with FERPA, Title VI, Section 504, and local-policy overlays.

US-regulatory

Control map

/us-regulatory/proposed-action

Maps AI control evidence across federal and state regimes without claiming agency acceptance.

EU AI Act

Art. 50 duty records

POST /v1/record · pack: eu-ai-act

Records marking and disclosure duty events — output_marked, disclosure_rendered, label_published — as sealed, offline-verifiable receipts. Art. 50 binds August 2, 2026.

CA SB 942

Transparency records

POST /v1/record · pack: ca-sb942

Seals AI-transparency duty events under California SB 942, enforceable August 2, 2026 — records that prove the duty was met, never a certification that you are compliant.

04 ·

The boundary is part of the reference.

integrate quickly, keep authority where it belongs
Planisphere returns

What teams can wire today.

  • decision: allow, needs_review, or block
  • action key, route hint, and review queue state
  • pack contract, policy overlay, and missing fields
  • signed receipt fields and public verification shape
  • federal exports with validation_profile status and blocking gaps
  • federal validation-run receipts with schema and artifact hashes
Planisphere does not return

What stays outside the API.

  • raw prompts, raw documents, raw keys, or provider secrets
  • private Planisphere math, scoring, or signing keys
  • legal, medical, export-control, or procurement approval
  • FedRAMP Certification, agency ATO status, or bid acceptance
  • official OSCAL validation, catalog publication, or award recommendation
  • public catalog publication without privacy, FOIA, and IP review
Open the Console Verify a receipt