Skip to main content
This page lists the JSON Schemas that the Intent API and the reference code are held to, with the canonical URL of each. It is for anyone validating a payload or generating a client. Every schema is published at a stable URL and embedded verbatim in the Intent API’s OpenAPI document, so a client generator never has to resolve a remote reference. The files are the single source of truth and the OpenAPI document is a mechanical copy.
Canonical URL: https://composer.id/schemas/admin-payload.jsonDates, budgets, cost centers, approvals, and administrative fields. Populated by the intake process; consumed by MappingProfiles during publish.
Canonical URL: https://composer.id/schemas/defence-file.jsonldMachine-readable evidence spine (JSON-LD) linked from the intent record and published destination objects. References the WorkAuthor signed PDF as the authoritative evidence artifact: stores a URI, never copies binaries.
Canonical URL: https://composer.id/schemas/diagnostics-bundle.jsonScored diagnostic evidence produced by Triage. Contains the assessment answers, scores, and ranked outcomes that drive the routing decision. This is path-2 (MSP reporting) data: only the resulting intent_id is published to destination systems.
Canonical URL: https://composer.id/schemas/enrichment-request.jsonEmitted back to Triage when preflight finds missing platform-required fields. The publish is withheld until all gaps are filled: the intent is never half-published.
Canonical URL: https://composer.id/schemas/intent-record.jsonCanonical system-of-engagement record keyed by intent_id.
Canonical URL: https://composer.id/schemas/linked-destination.jsonCapability and requirements metadata for a connected tenant destination.
Canonical URL: https://composer.id/schemas/mapping-profile.jsonField translation template from canonical intent/workforce models to a platform-specific API dialect. The unit of portability: swap the profile, keep the intent.
Canonical URL: https://composer.id/schemas/passthrough-request.jsonRaw platform API call anchored to an intent_id. Escape hatch for fields or endpoints not covered by MappingProfiles: the call is logged on the intent timeline for auditability.
Canonical URL: https://composer.id/schemas/publishing-bundle.jsonPublish receipts, external IDs, idempotency keys, and adapter status. Populated on the IntentRecord after the first successful publish.
Canonical URL: https://composer.id/schemas/reconciliation-report.jsonDrift detection report produced when the destination system’s record diverges from the canonical intent. Field-level comparison via the MappingProfile.
Canonical URL: https://composer.id/schemas/routing-payload.jsonChannel + destination payload in canonical field names (the Common Workforce Model). These are the platform-neutral fields that MappingProfiles translate into destination-specific API dialects.
Canonical URL: https://composer.id/schemas/timeline-event.jsonImmutable append-only event for the intent audit trail. Events are never mutated or deleted.
Canonical URL: https://composer.id/schemas/webhook-event.jsonBack-sync event envelope delivered by composerID webhooks, and accepted inbound at POST /webhooks/{platform}. Signed in transport, not in the body: each delivery carries one or more X-Signature-HMAC-SHA256-{n} headers, each the Base64 HMAC-SHA256 of the raw body under an active signing key; any one match verifies, so keys rotate without downtime.
defence-file.jsonld is the Compliance File: the prose was renamed in August 2026 and the schema keeps the old name until a versioned rename.