Developers
Twelfth Developer Resources
Twelfth's public REST API is deliberately small. It starts with GET https://api.twelfth.ai/workspace for workspace identity and operating defaults, and GET https://api.twelfth.ai/tasks for the current open, unsnoozed task list. Resources are added only when their public contracts and permissions are ready.
A workspace owner or admin creates a dedicated API key under Settings → AI & agents. Send it as an Authorization bearer token from server-side code, and give every server, script or automation its own labelled key so it can be audited and revoked independently.
The OpenAPI 3.1 document is the canonical contract for operations, schemas, authentication, structured errors and rate limits. Paths are stable and unversioned; published operations evolve additively rather than moving to /v2 or /v3.
Committed decisions can also be delivered to your systems by signed webhook. Contact us and we will set one up for your workspace.
Developer resources
- Developer API guide→
Authentication, request example, errors, rate limits and the boundary between public and internal routes.
- API reference→
Searchable operations and schemas generated from the public contract.
- API compatibility→
The additive compatibility rules for stable, unversioned paths.
- Twelfth webhooks→
Signed delivery of committed decisions to your systems, set up on request.
- Twelfth OpenAPI description→
Machine-readable REST operations, schemas, typed errors and rate limits.
- Twelfth llms.txt→
Agent-readable map of Twelfth's public pages and developer resources.
- Twelfth product documentation→
Product setup, workspace administration and AI connection guides.
Twelfth UI: components for category managers
The figures a buyer reads every day, taken out of Twelfth as React components anyone can install: price position against a competitor, a pricing scoreboard, sales against forecast with its range, weeks of cover against the band, and the small charts and change indicators that sit in a table cell. Each one installs with a single command into any React app, and every page has a live playground, the code for each variant, and buttons to open it in v0, Lovable, Claude or ChatGPT.
- Twelfth UI→
Browse every component, try its props and copy the install command.
- Price position→
Our prices against a competitor, with the matched-line evidence on hover.
- Micro trend→
Sales against forecast, this year against last, stock against the reorder point, small enough for a table cell.
- Component registry index→
Machine-readable list of every component, for the component CLI and AI tools.
- twelfth-ai/catman-ui on GitHub→
The components' source, MIT licensed, mirrored from the live registry.
Developer questions
- Q01Does Twelfth have an API?
- Yes. Twelfth has a public REST API at
https://api.twelfth.aiwith stable, unversioned resource paths. It currently supports GET /workspace and GET /tasks with a workspace API key. New operations are added to the OpenAPI contract only when they are supported for external callers. Committed decisions can also be delivered by signed webhook. - Q02How do I authenticate?
- Create a workspace API key as a workspace owner or admin, then send it from server-side code as Authorization: Bearer <key>. Use a separate labelled key for each integration and never expose one in browser code or source control.
- Q03Can I use Twelfth's components in my own app?
- Yes. Twelfth UI at https://ui.twelfth.ai publishes the retail components from the product, such as price position, sales against forecast and weeks of cover, as a component registry. Each installs into a React project with one command and arrives as source you own, styled by your theme. The components are open source under the MIT licence.
- Q04Can the Twelfth API write or change data?
- Not currently. The first REST resource is read-only. Twelfth will add write operations only with explicit permissions, idempotency and audit behaviour documented in the public contract.
