# API surface map (/docs/reference/api-surface-map)
This page is the master index of the Ductor API surface. Every tag in the
[OpenAPI spec](/docs/api-reference) — all 87 of them — has a row here, so any
capability you can call has a discoverable answer to "what is this, and where is
it documented?" For how the API is served (transports, interceptor chain,
versioning, health endpoints), see [API surface](/docs/reference/api-surface);
for the browsable method list, see the [API reference](/docs/api-reference).
The tags speak the API's own names — `Routing`, `Auctions`, `Pricing`,
`Capacity` — which are the technical surface under the public
[clearing primitives](/docs/primitives). If you arrived from the primitive
vocabulary, the [glossary](/docs/reference/glossary) carries the bridge: a
is a routing `Decision`, a lands in an
auction or ping/post tag, and spans the pricing and
billing tags below.
The **Docs home** column links to the narrative page that covers a tag. Where it
reads **API reference only**, the capability is real and callable, but it is
documented at the endpoint level in the OpenAPI reference rather than in a
narrative page. A few tags have no dedicated page yet and point at the nearest
home that covers them, marked *(nearest home)*.
## The master index [#the-master-index]
| Tag | Capability | Docs home |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| AI Inference | Score routables and predict outcomes with ML models for optimized assignment. | [ai/inference-proxy](/docs/ai/inference-proxy) |
| Action Templates | Author, validate, and version tenant-scoped YAML template actions for the builder catalog. | [sdks/extensions](/docs/sdks/extensions) |
| Agent Presets | Reusable agent config presets (prompt, model, tools) referenced by workflow steps. | [ai/agent-presets](/docs/ai/agent-presets) |
| Agent Sessions | Live and historical agent conversation sessions, transcripts, and tool-call traces. | [ai/chat-agent](/docs/ai/chat-agent) |
| Agent Tool Exposure | Governed tool exposure for AI agents and MCP clients: manifests, leases, decision receipts. | [ai/agent-tool-security](/docs/ai/agent-tool-security) |
| Analytics | Query routing metrics, throughput, conversion rates, and operational dashboards. | API reference only |
| Approvals | Human approval gates for workflow steps: list, inspect, approve, reject, cancel. | [management/workflows](/docs/management/workflows) *(nearest home)* |
| Archive | Archive, search, and retrieve historical routing decisions and events from long-term storage. | [operations/workflow-runtime](/docs/operations/workflow-runtime) *(nearest home)* |
| Artifact Graph | Inspect routing-artifact dependencies, dependents, and stale markers with safe previews. | API reference only |
| Auctions | Reverse Dutch auction engine for unsold routables with automated price ticks. | [strategies/markets](/docs/strategies/markets) |
| Billing | Read-only billing summary and customer-portal link for the workspace. | [billing/stripe](/docs/billing/stripe) |
| Buy Orders | Standing price-threshold and attribute-filter orders for automatic auction matching. | [strategies/markets](/docs/strategies/markets) *(nearest home)* |
| Capabilities | Read-only enterprise capability discovery for admins, builders, and SDKs. | API reference only |
| Capacity | Capacity marketplace: listings, trades, order books, and market parameters. | [strategies/capacity](/docs/strategies/capacity) |
| Cases | Case lifecycle: create, assign, escalate, resolve, and close with SLA tracking. | [management/cases](/docs/management/cases) |
| Claim Queues | Recipient self-selection of work items from a shared lead-pond queue. | [management/pools-and-recipients](/docs/management/pools-and-recipients) *(nearest home)* |
| Compliance | Data-retention policies, audit logs, and regulatory compliance requirements. | [billing/commerce](/docs/billing/commerce) |
| Config | Runtime configuration keys, feature flags, and operational settings. | [management/configuration](/docs/management/configuration) |
| Connector Authoring | Governed just-in-time connector function authoring with compile and dry-run. | [connectors/assisted-authoring](/docs/connectors/assisted-authoring) |
| Connector Canaries | Synthetic canaries that probe safe connector actions with redacted evidence. | [connectors/certification-and-testing](/docs/connectors/certification-and-testing) |
| Connector Execution Admission | Admission policy, fairness groups, and receipts for governed headless execution. | [connectors/policies-quotas-audit](/docs/connectors/policies-quotas-audit) |
| Connectors | Provider catalog and tenant connection management with encrypted credentials and OAuth2. | [connectors](/docs/connectors) |
| Consent | Record, query, and revoke consumer consent for routing and contact. | [billing/commerce](/docs/billing/commerce) *(nearest home)* |
| Contexts | Tenant-scoped context entities with arbitrary JSON payloads for workflow steps. | [management/secrets-and-variables](/docs/management/secrets-and-variables) |
| Dead Letter Queue | Inspect, retry, or purge items that failed routing after exhausting retries. | [operations/queue-operations](/docs/operations/queue-operations) |
| Deduplication | Detect and manage duplicate routables with configurable matching strategies. | [concepts/deduplication-and-outcomes](/docs/concepts/deduplication-and-outcomes) |
| Entitlements | Capability entitlement facts and runtime eligibility decisions per tenant/environment. | [auth/entitlements](/docs/auth/entitlements) |
| Entity Identity | Resolve routables and records into redacted identity profiles; merge and split. | API reference only |
| Environments | Sandbox, staging, and production environment records without exposing credentials. | [management/environments](/docs/management/environments) |
| Events | Query, replay, and manage the append-only event stream for audit and debugging. | [concepts/events](/docs/concepts/events) *(nearest home)* |
| Experiments | Durable A/B tests for routing strategies, workflow steps, and agent definitions with exposure-bound delayed scores. | [management/experiments](/docs/management/experiments) |
| Forecast | Predict routing volume and capacity needs from historical and seasonal patterns. | [strategies/yield-and-quality](/docs/strategies/yield-and-quality) |
| Health | Readiness, liveness, and dependency-connectivity checks. | [operations/health-checks](/docs/operations/health-checks) |
| Inbox | Per-subscriber inbox lifecycle: read/seen, snooze, archive, delete, CTAs. | [notifications/inbox](/docs/notifications/inbox) |
| Layouts | Reusable channel-scoped envelopes that wrap rendered notification content. | [notifications](/docs/notifications) |
| Management | Pool and recipient topology, weights, schedules, and capacity limits. | [management/pools-and-recipients](/docs/management/pools-and-recipients) |
| Marketplace | Publish and install durable extension artifacts with tenant-scoped state. | [connectors/marketplace-and-deployments](/docs/connectors/marketplace-and-deployments) |
| Members | Workspace member roster plus RBAC role and scope catalogs. | [auth/members](/docs/auth/members) |
| Modules | Reusable module and module-version definitions for the workflow catalog. | API reference only |
| Notification Integrations | Bind a (tenant, channel, provider) tuple to a connector connection holding credentials. | [notifications](/docs/notifications) |
| Notification Recovery | Inspect redacted delivery observations and dead letters, then perform explicit audited redrive. | [notifications/delivery-reliability](/docs/notifications/delivery-reliability) |
| Notification Subscribers | Notification recipients, channel endpoints, subscriptions, and preferences. | [notifications](/docs/notifications) |
| Notification Topics | Named subscriber groups within a tenant plus membership. | [notifications](/docs/notifications) |
| Notification Triggers | Multi-channel dispatch: resolve subscriber, apply preferences, render, deliver. | [notifications](/docs/notifications) |
| Outcomes | Track what happened to routed items: contact status, conversion, returns. | [concepts/deduplication-and-outcomes](/docs/concepts/deduplication-and-outcomes) |
| Ping Post | Two-phase routing with a preliminary acceptance check before full submission. | [strategies/markets](/docs/strategies/markets) *(nearest home)* |
| Policies | Governed CEL policy packs: create, compile, publish, validate, inspect. | [strategies/governance](/docs/strategies/governance) *(nearest home)* |
| Postbacks | Record and query outcome notifications received from downstream systems. | [connectors/outbound-integrations](/docs/connectors/outbound-integrations) *(nearest home)* |
| Pricing | Per-item pricing, dynamic CEL expressions, budgets, and transaction history. | [billing/commerce](/docs/billing/commerce) |
| Promotions | Promotion lifecycle: candidates, preflight, canary controls, approvals, rollback. | [operations/promotions-and-rollout](/docs/operations/promotions-and-rollout) |
| Publishers | Register and configure publishers that supply routables with acceptance rates. | [management/publishers](/docs/management/publishers) |
| Quality | Define and evaluate quality metrics for routables and recipients. | [strategies/yield-and-quality](/docs/strategies/yield-and-quality) |
| Queues | Inspect, peek, requeue, and manage items waiting for recipients. | [operations/queue-operations](/docs/operations/queue-operations) |
| Returns | Process item returns, issue credits, and re-route returned items. | [billing/commerce](/docs/billing/commerce) |
| Rollout Evidence | Controlled proof captures and redacted artifacts bound to promotion candidates. | [operations/promotions-and-rollout](/docs/operations/promotions-and-rollout) |
| Routing | Core engine: route items, replay decisions, run what-if simulations, get explainability. | [concepts/routing-pipeline](/docs/concepts/routing-pipeline) |
| Routing Eligibility | Recipient eligibility traits, assignments, territory sets, and redacted match previews. | [strategies/eligibility](/docs/strategies/eligibility) |
| Routing Markets | Market sessions: preview, open, bid, clear, commit, replay, cancel with typed lineage. | [strategies/markets](/docs/strategies/markets) |
| Routing Reliability | Target-readiness facts, stale sources, decision-linked evidence, and override staging. | [strategies/reliability](/docs/strategies/reliability) |
| Routing Scenarios | Redacted simulation scenario packs and no-side-effect suite runs. | API reference only |
| Routing Strategies | Governed custom-strategy runtime discovery, health, and safe dry-runs. | [strategies/contracts](/docs/strategies/contracts) |
| Routing Strategy State | Inspect, explain, export/import, reset, and repair strategy state. | API reference only |
| Rules | CEL-expression eligibility and assignment constraints evaluated at routing time. | [management/rules](/docs/management/rules) |
| Runtime Config | Redacted runtime configuration dependency contracts and binding validation. | [management/configuration](/docs/management/configuration) |
| Runtime Conformance | Conformance suites and coverage for workflow, bridge, worker, MCP, and admission. | [operations/promotions-and-rollout](/docs/operations/promotions-and-rollout) |
| SLA | Monitor SLA compliance for routing response times and escalation triggers. | [management/pools-and-recipients](/docs/management/pools-and-recipients) *(nearest home)* |
| Secrets | AEAD-encrypted, environment-partitioned tenant secrets; only metadata is returned. | [management/secrets-and-variables](/docs/management/secrets-and-variables) |
| Strategy Certification | Conformance workbench: suites, certification, receipts, waivers, activation blocks. | [strategies/governance](/docs/strategies/governance) |
| Strategy Learning | Outcome attribution and privacy-safe training datasets for model evaluation. | [strategies/learning](/docs/strategies/learning) |
| Strategy Optimization | Optimization proposals and tuning runs converted to experiments or candidates. | [strategies/governance](/docs/strategies/governance) |
| Strategy Shadow Campaigns | Run candidate strategies against real traffic without affecting authoritative decisions. | [strategies/governance](/docs/strategies/governance) |
| Tables | Tenant-scoped user-defined tables with dynamic schema and row operations. | API reference only |
| Tenant API Keys | Tenant-owned API key lifecycle; the raw key is returned only on creation. | [management/api-keys](/docs/management/api-keys) |
| Tenant Config | Per-tenant settings, overrides, and feature enablement. | [management/configuration](/docs/management/configuration) |
| Tenant Weights | Per-tenant routing weight distributions and allocation ratios. | [strategies/balance](/docs/strategies/balance) *(nearest home)* |
| Tenants | Tenant lifecycle: create, update, suspend, delete with config inheritance. | [management/tenants](/docs/management/tenants) |
| Usage Metering | Usage rollups, budget-impact previews, and warn/shadow-deny/deny policies. | [billing/usage-metering](/docs/billing/usage-metering) |
| Variables | Plaintext, environment-partitioned config variables returned in API responses. | [management/secrets-and-variables](/docs/management/secrets-and-variables) |
| Webhooks | Register HTTP callbacks for real-time events with retry and signature verification. | [connectors/outbound-integrations](/docs/connectors/outbound-integrations) |
| Work Assignment | Route case/task assignment through the shared routing substrate with idempotent receipts. | [strategies/work](/docs/strategies/work) |
| Workflow Definitions | Create, edit, publish, and archive DAG workflow definitions. | [management/workflows](/docs/management/workflows) |
| Workflow Runs | Durable run control: pause, resume, cancel, redrive, continue-as-new. | [management/workflows](/docs/management/workflows) |
| Workflow Signals | Approve, reject, and resolve signals delivered to waiting steps. | [management/workflows](/docs/management/workflows) |
| Workflow Triggers | Start workflow runs from API calls, webhooks, or scheduled events. | [management/workflows](/docs/management/workflows) |
| Workflow Visibility | DQL run search/scan/count plus visibility-index attribute and alias CRUD. | API reference only |
| Workflows | Inspect running and completed runs: step history, timeline, wakeups, and audit. | [management/workflows](/docs/management/workflows) |
| Yield | Maximize routing value via dynamic pricing and capacity allocation. | [strategies/yield-and-quality](/docs/strategies/yield-and-quality) |
This index is generated from the tag list in `api/openapi/openapi.yaml`. If a
new tag ships without a row here, that is a documentation gap — every callable
capability belongs in this table.