# composerID

> composerID is an API that publishes a workforce decision reference into the systems that execute it.

- [Introduction](https://www.composer.id/index.md): composerID is an API that publishes a workforce decision reference into the systems that execute it. Start here.
- [Quickstart](https://www.composer.id/quickstart.md): Mint a sandbox key and publish your first workforce decision into a destination in five API calls. Nothing to install.
- [Authentication](https://www.composer.id/authentication.md): How Intent API requests authenticate: personal sandbox keys, OAuth 2.0 client credentials, scopes, token lifetime and the signed webhook exception.
- [How it works](https://www.composer.id/concepts/how-it-works.md): The three jobs in a workforce technology stack, the Intent ID that joins them, and what does and does not cross into a destination.
- [The Intent ID](https://www.composer.id/concepts/decision-reference.md): The one identifier minted when Triage reaches a decision and carried into every system that records it: shape, minting, versions and carrier fields.
- [Publishing](https://www.composer.id/concepts/publishing.md): How a decision becomes a valid record in each destination: plan, preflight, publish, the enrichment loop and the idempotency key.
- [Events and the timeline](https://www.composer.id/concepts/events.md): The append-only timeline behind every Intent ID, the verified webhooks that feed it in both directions, and reconciliation after go-live.
- [Score and manuscript](https://www.composer.id/concepts/two-paths.md): A destination receives the score, a valid request with the Intent ID. The manuscript behind the decision is served separately to those entitled to it.
- [The Compliance File](https://www.composer.id/concepts/compliance-file.md): The evidence pack behind a decision: what it holds, the schema it follows, where each piece comes from, and who may read it.
- [Question types](https://www.composer.id/concepts/question-types.md): The 32 question and data types Triage can ask, and the 20 whose answers composerID carries into a destination field.
- [Published schemas](https://www.composer.id/concepts/schemas.md): The JSON Schemas the Intent API and the reference code are held to, with their canonical URLs.
- [The life of one Intent](https://www.composer.id/guides/lifecycle.md): One statement-of-work request followed end to end: decision, sourcing, contract, signature, committed spend and audit, under one Intent ID.
- [How composerID connects](https://www.composer.id/guides/connect.md): The five ways composerID reaches a destination, the minimum destination standard, and when a client incurs cost or configuration change.
- [Publishing to Beeline](https://www.composer.id/guides/beeline.md): How composerID publishes a decision into Beeline's Client APIs with the Intent ID in externalId, reads the site first and listens for events.
- [Destinations](https://www.composer.id/destinations/index.md): Every destination composerID documents, its category and how far the integration has progressed.
- [Beeline](https://www.composer.id/destinations/beeline.md): Beeline (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Coupa](https://www.composer.id/destinations/coupa.md): Coupa (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [GEP](https://www.composer.id/destinations/gep.md): GEP (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Globality](https://www.composer.id/destinations/globality.md): Globality (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Ivalua](https://www.composer.id/destinations/ivalua.md): Ivalua (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [JAGGAER](https://www.composer.id/destinations/jaggaer.md): JAGGAER (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SAP Ariba](https://www.composer.id/destinations/ariba.md): SAP Ariba (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SAP Fieldglass](https://www.composer.id/destinations/fieldglass.md): SAP Fieldglass (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SimplifyVMS](https://www.composer.id/destinations/simplifyvms.md): SimplifyVMS (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [VNDLY](https://www.composer.id/destinations/vndly.md): VNDLY (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Workday](https://www.composer.id/destinations/workday.md): Workday (Vendor Management & Sourcing): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Basware](https://www.composer.id/destinations/basware.md): Basware (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Fairmarkit](https://www.composer.id/destinations/fairmarkit.md): Fairmarkit (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Keelvar](https://www.composer.id/destinations/keelvar.md): Keelvar (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Omnea](https://www.composer.id/destinations/omnea.md): Omnea (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [ORO Labs](https://www.composer.id/destinations/oro.md): ORO Labs (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Tonkean](https://www.composer.id/destinations/tonkean.md): Tonkean (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Zip](https://www.composer.id/destinations/zip.md): Zip (Procurement Orchestration): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Microsoft Dynamics 365](https://www.composer.id/destinations/dynamics365.md): Microsoft Dynamics 365 (ERP): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [NetSuite](https://www.composer.id/destinations/netsuite.md): NetSuite (ERP): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Oracle](https://www.composer.id/destinations/oracle.md): Oracle (ERP): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SAP S/4HANA](https://www.composer.id/destinations/s4hana.md): SAP S/4HANA (ERP): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [ADP](https://www.composer.id/destinations/adp.md): ADP (HRIS / HCM): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [BambooHR](https://www.composer.id/destinations/bamboohr.md): BambooHR (HRIS / HCM): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Ceridian Dayforce](https://www.composer.id/destinations/dayforce.md): Ceridian Dayforce (HRIS / HCM): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Oracle HCM](https://www.composer.id/destinations/oraclehcm.md): Oracle HCM (HRIS / HCM): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SAP SuccessFactors](https://www.composer.id/destinations/successfactors.md): SAP SuccessFactors (HRIS / HCM): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [UKG](https://www.composer.id/destinations/ukg.md): UKG (HRIS / HCM): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Avature](https://www.composer.id/destinations/avature.md): Avature (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Bullhorn](https://www.composer.id/destinations/bullhorn.md): Bullhorn (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Eightfold](https://www.composer.id/destinations/eightfold.md): Eightfold (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Greenhouse](https://www.composer.id/destinations/greenhouse.md): Greenhouse (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [iCIMS](https://www.composer.id/destinations/icims.md): iCIMS (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Lever](https://www.composer.id/destinations/lever.md): Lever (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SmartRecruiters](https://www.composer.id/destinations/smartrecruiters.md): SmartRecruiters (ATS): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Adobe Acrobat Sign](https://www.composer.id/destinations/adobesign.md): Adobe Acrobat Sign (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Agiloft](https://www.composer.id/destinations/agiloft.md): Agiloft (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Conga CLM](https://www.composer.id/destinations/conga.md): Conga CLM (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [ContractPodAi (Leah)](https://www.composer.id/destinations/contractpodai.md): ContractPodAi (Leah): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [DocuSign](https://www.composer.id/destinations/docusign.md): DocuSign (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Dropbox Sign](https://www.composer.id/destinations/dropboxsign.md): Dropbox Sign (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Evisort (Workday Contract Intelligence)](https://www.composer.id/destinations/evisort.md): Evisort (Workday Contract Intelligence): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Gatekeeper](https://www.composer.id/destinations/gatekeeper.md): Gatekeeper (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Icertis](https://www.composer.id/destinations/icertis.md): Icertis (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Ironclad](https://www.composer.id/destinations/ironclad.md): Ironclad (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Juro](https://www.composer.id/destinations/juro.md): Juro (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [LinkSquares](https://www.composer.id/destinations/linksquares.md): LinkSquares (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Malbek](https://www.composer.id/destinations/malbek.md): Malbek (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [PandaDoc](https://www.composer.id/destinations/pandadoc.md): PandaDoc (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Sirion](https://www.composer.id/destinations/sirion.md): Sirion (Signature & Contract Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [ServiceNow](https://www.composer.id/destinations/servicenow.md): ServiceNow (ITSM / Service Management): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [SAP BTP](https://www.composer.id/destinations/sapbtp.md): SAP BTP (Systems Integrations): the API posture, publish target and field mapping composerID publishes a decision reference through.
- [Upstream connectors](https://www.composer.id/connectors/overview.md): How Triage's diagnostic runs inside chat and portal surfaces through the Intake Gateway, and where composerID takes over.
- [Microsoft Teams](https://www.composer.id/connectors/teams.md): Developer notes for the Teams upstream connector: Bot Framework, Adaptive Cards (v1.5 bot-sent, v1.2 mobile), Entra ID SSO and proactive messages.
- [Slack](https://www.composer.id/connectors/slack.md): Developer notes for the Slack upstream connector: Block Kit, chat.postMessage and chat.update, bot scopes, interactivity and transport.
- [Google Chat](https://www.composer.id/connectors/googlechat.md): Developer notes for the Google Chat upstream connector: Cards v2 over the Chat API, interaction events and dialogs, JWT request verification.
- [ServiceNow](https://www.composer.id/connectors/servicenow.md): Developer notes for the ServiceNow upstream connector: Service Portal widgets, Employee Center, Glide session auth and the round trip into the instance.
- [API reference](https://www.composer.id/api-reference/overview.md): The two composerID APIs side by side: the Intent API that publishes a decision reference and the Manuscript API that serves the evidence behind it.
- [MCP tools](https://www.composer.id/api-reference/mcp.md): The composerID MCP tool family for agents: five tools that mirror the Intent API one for one, the front-door rule and the guardrails around them.
- [Exchange client credentials for a short-lived, scoped bearer token](https://www.composer.id/api-reference/auth/exchange-client-credentials-for-a-short-lived-scoped-bearer-token.md): RFC 6749 section 4.4. Send `grant_type=client_credentials` with the client id and secret as HTTP Basic credentials (or in the body), optionally narrowing `scope`. The response is not cacheable. Tokens expire after `expires_in` seconds; request a new one on 401.
- [Mint self-serve sandbox credentials: a personal key, an OAuth client and a webhook signing key for a new tenant](https://www.composer.id/api-reference/auth/mint-self-serve-sandbox-credentials:-a-personal-key-an-oauth-client-and-a-webhook-signing-key-for-a-new-tenant.md): The sandbox issues its own credentials: no account, no form. One call creates a tenant with a personal API key, an OAuth client (id and secret for `POST /oauth/token`) and a webhook signing key, all carrying every scope and all expiring together (see `expires_at`). The secrets are shown once. Rate-l…
- [Turn a completed Triage assessment into an intent](https://www.composer.id/api-reference/intent/turn-a-completed-triage-assessment-into-an-intent.md): The START of the lifecycle: Triage decides, and its completion webhook turns the decision into an intent here. The delivery is authenticated by the `X-Signature-HMAC-SHA256-{n}` header, signed with the tenant's webhook signing key. The Intent ID is a pure function of the assessment response id, so a…
- [Create an intent record (returns intent_id)](https://www.composer.id/api-reference/intent/create-an-intent-record-returns-intent_id.md)
- [Fetch the canonical intent record](https://www.composer.id/api-reference/intent/fetch-the-canonical-intent-record.md)
- [Patch diagnostics/routing/admin fields](https://www.composer.id/api-reference/intent/patch-diagnosticsroutingadmin-fields.md)
- [Fetch timeline events for audit](https://www.composer.id/api-reference/intent/fetch-timeline-events-for-audit.md)
- [Emit missing fields back to Triage/Intake](https://www.composer.id/api-reference/intent/emit-missing-fields-back-to-triageintake.md)
- [Generate destination plan from Channel Map + intent](https://www.composer.id/api-reference/routing/generate-destination-plan-from-channel-map-+-intent.md)
- [Validate intent against platform requirements](https://www.composer.id/api-reference/routing/validate-intent-against-platform-requirements.md)
- [Idempotent publish to target platform via adapter](https://www.composer.id/api-reference/publishing/idempotent-publish-to-target-platform-via-adapter.md): Writes the intent into the destination through its adapter and returns a receipt carrying the destination's own record id, the deterministic idempotency key and the exact payload written. A retry with the same intent version returns the original receipt with `replayed: true` and creates nothing. Sen…
- [Send raw JSON to a platform endpoint](https://www.composer.id/api-reference/publishing/send-raw-json-to-a-platform-endpoint.md)
- [Detect drift between VMS state and canonical intent](https://www.composer.id/api-reference/publishing/detect-drift-between-vms-state-and-canonical-intent.md)
- [Receive a signed destination event and record it on the intent's timeline](https://www.composer.id/api-reference/publishing/receive-a-signed-destination-event-and-record-it-on-the-intents-timeline.md): Inbound delivery from a destination platform, addressed to the destination's webhook URL for this tenant. No bearer token: the `X-Signature-HMAC-SHA256-1` header authenticates the delivery and an unverifiable one is rejected, not queued. The body must reference an Intent ID this tenant minted; the e…
- [A requisition changed in the destination system](https://www.composer.id/api-reference/publishing/a-requisition-changed-in-the-destination-system.md): Delivered to the subscriber's endpoint and signed with HMAC-SHA256 over the raw body. Verification is multi-key so signing keys can rotate; an unverifiable delivery is rejected, not queued.
- [An assignment changed](https://www.composer.id/api-reference/publishing/an-assignment-changed.md): Delivered to the subscriber's endpoint and signed with HMAC-SHA256 over the raw body. Verification is multi-key so signing keys can rotate; an unverifiable delivery is rejected, not queued.
- [Timesheet changed](https://www.composer.id/api-reference/publishing/timesheet-changed.md): Delivered to the subscriber's endpoint and signed with HMAC-SHA256 over the raw body. Verification is multi-key so signing keys can rotate; an unverifiable delivery is rejected, not queued.
- [Tenant auth revoked](https://www.composer.id/api-reference/publishing/tenant-auth-revoked.md): Delivered to the subscriber's endpoint and signed with HMAC-SHA256 over the raw body. Verification is multi-key so signing keys can rotate; an unverifiable delivery is rejected, not queued.
- [List platforms and doc availability](https://www.composer.id/api-reference/discovery/list-platforms-and-doc-availability.md)
- [List connected destinations and capabilities](https://www.composer.id/api-reference/discovery/list-connected-destinations-and-capabilities.md)
- [Capability matrix + required fields per object/op](https://www.composer.id/api-reference/discovery/capability-matrix-+-required-fields-per-objectop.md)
- [Manuscript API](https://www.composer.id/api-reference/manuscript/overview.md): The Manuscript API serves the full record behind a published score: assessments, documents, surveys, workflows and signed PDFs, with signed webhooks.
- [Signed webhooks](https://www.composer.id/api-reference/manuscript/webhooks.md): How Manuscript API webhook deliveries are signed and verified: HMAC-SHA256 over the raw body, with several keys during rotation.
- [Webhook events](https://www.composer.id/api-reference/manuscript/webhook-events.md): The event types the Manuscript API can deliver, and the per-document notification configuration a create call accepts.
- [List assessments](https://www.composer.id/api-reference/manuscript/assessments/list-assessments.md): Paged list of assessments: name, group, status, tags and response counts.
- [Get a scored assessment response](https://www.composer.id/api-reference/manuscript/assessments/get-a-scored-assessment-response.md): The full scored response: responseId, depReference, externalId, user, start and end dates, score, scoreDescription, sectionScores, questions, notes and rankedScores.
- [List an assessment's scored responses](https://www.composer.id/api-reference/manuscript/assessments/list-an-assessments-scored-responses.md): Paged list of one assessment's scored responses, filterable by From and To dates.
- [List document templates](https://www.composer.id/api-reference/manuscript/documents/list-document-templates.md): Paged list of templates, filterable by UserEmail.
- [Get a template's fields](https://www.composer.id/api-reference/manuscript/documents/get-a-templates-fields.md): A template's fields and their types: what a create call must supply.
- [Create a document from a template](https://www.composer.id/api-reference/manuscript/documents/create-a-document-from-a-template.md): Create a document from templateId and templateFields, with owner, co-author, name, externalId and an optional per-document eventNotification. Returns 201 with id and url.
- [Get a document and its lifecycle](https://www.composer.id/api-reference/manuscript/documents/get-a-document-and-its-lifecycle.md): Status plus the dated lifecycle, owner, co-authors, collaborators, entities and workflows.
- [List surveys](https://www.composer.id/api-reference/manuscript/surveys/list-surveys.md): Paged list of surveys.
- [List a survey's responses](https://www.composer.id/api-reference/manuscript/surveys/list-a-surveys-responses.md): Paged responses for one survey, filterable by From and To dates.
- [Get a survey response](https://www.composer.id/api-reference/manuscript/surveys/get-a-survey-response.md): A survey response: user, submitted, and every question with its rating and answer.
- [Get the signed PDF for a workflow](https://www.composer.id/api-reference/manuscript/workflows/get-the-signed-pdf-for-a-workflow.md): The signed PDF for the workflow: the Compliance File's pdf_signed evidence source.
- [Get a workflow](https://www.composer.id/api-reference/manuscript/workflows/get-a-workflow.md): parentId, parentType, type, status, created and last-updated dates.
- [Tiers](https://www.composer.id/tiers.md): composerID ships as a module of Triage, never as a separate product. What each tier connects, from standalone to bi-directional sync.
- [Changelog](https://www.composer.id/changelog.md): What changed in composerID's documentation, contracts and reference code, newest first.
- [API terms](https://www.composer.id/legal/api-terms.md): The composerID API Terms: the reference sandbox, credentials and scopes, restrictions, data, confidentiality, warranties and liability.
- [Data processing agreement](https://www.composer.id/legal/dpa.md): composerID Data Processing Agreement: Deployed as processor under UK and EU GDPR, with Annexes on processing, security and sub-processors.
- [End user terms](https://www.composer.id/legal/end-user-terms.md): Plain-language terms for people whose work requests pass through composerID inside their organisation’s Triage deployment.
- [Privacy policy](https://www.composer.id/legal/privacy.md): How Deployed collects and uses personal data through composer.id and the reference sandbox, and the rights you have under the UK GDPR.
- [Terms of use](https://www.composer.id/legal/terms.md): Terms of Use for the composerID website, documentation and reference sandbox, provided by Deployed under the law of England and Wales.

## OpenAPI Specs

- [openapi](/api-reference/manuscript/openapi.json)
- [openapi](/api-reference/openapi.json)