# AionCX Documentation

> Use Atlas to run customer operations and Mach-1 to transcribe, analyze, and forecast through Build, REST, and MCP.

- [AionCX documentation](https://docs.aioncx.com/index.md): Use Atlas to run customer operations and Mach-1 to transcribe, analyze, and forecast through Build, REST, and MCP.
- [Start using Atlas](https://docs.aioncx.com/atlas/get-started.md): Choose your workspace, find the tools available to your role, and complete your first Atlas task.
- [Transcribe your first recording](https://docs.aioncx.com/quickstart.md): Use AionCX Build to submit audio, follow processing, inspect the transcript, and add analysis.
- [Start here for AI agents](https://docs.aioncx.com/agents/quickstart.md): Discover AionCX documentation, select the right scoped credential, and complete Mach-1 or Atlas tasks through existing APIs and MCP tools.
- [Atlas and the five Agencies](https://docs.aioncx.com/atlas/overview.md): Find the Atlas workflows for staffing, quality, customer intelligence, workforce development, and knowledge operations.
- [Prepare a staffing plan and schedule](https://docs.aioncx.com/atlas/resource-management.md): Review workforce configuration, forecast demand, calculate requirements, generate a draft, and publish a reviewed Atlas schedule.
- [Review interactions and evidence](https://docs.aioncx.com/atlas/review-interactions.md): Inspect conversation findings, source passages, and quality evaluations in Atlas before taking action.
- [Edit, review, and publish knowledge](https://docs.aioncx.com/atlas/knowledge-operations.md): Maintain knowledge articles in Atlas, review changes, publish approved versions, and inspect supported delivery results.
- [Metrics and terms](https://docs.aioncx.com/reference/metrics-and-terms.md): Understand Atlas forecast groups, scheduling groups, demand, coverage, shrinkage, findings, and evidence.
- [The Mach-1 pipeline](https://docs.aioncx.com/mach1/overview.md): Move from audio to transcripts, classifications, extracted findings, evaluations, evidence, and forecasts.
- [Transcribe audio](https://docs.aioncx.com/mach1/transcription.md): Submit an audio file or URL to Mach-1 and inspect the resulting transcript, speaker attribution, and source evidence.
- [Classify, extract, summarize, and evaluate](https://docs.aioncx.com/mach1/analysis.md): Choose published Mach-1 analysis Definitions and turn audio or existing transcripts into structured findings with evidence.
- [Results and evidence](https://docs.aioncx.com/mach1/results.md): Inspect asynchronous status, transcript, findings and source audio.
- [Forecast from numerical history](https://docs.aioncx.com/mach1/forecasting.md): Submit numerical series or authorized metrics to Mach-1, use supported drivers, and retrieve saved forecasts through REST or MCP.
- [Sources and transcript producers](https://docs.aioncx.com/mach1/sources.md): Choose a connected source or submit existing producer output.
- [Usage and pricing](https://docs.aioncx.com/mach1/usage.md): Understand shared Mach-1 credit, audio-duration charges, current forecast charges, and funding.
- [Forecasting pricing](https://docs.aioncx.com/mach1/forecasting-pricing.md): Understand the current zero-dollar Mach-1 forecast charge and where to check account-specific processing rates and credit.
- [Errors, retries and limits](https://docs.aioncx.com/mach1/errors.md): Handle admission failures and uncertain outcomes safely.
- [AionCX API overview](https://docs.aioncx.com/api-reference/overview.md): Find Mach-1 conversation and forecasting APIs, native Atlas MCP tools, and paired Workforce REST/MCP contracts.
- [Authentication](https://docs.aioncx.com/api-reference/authentication.md): Human sessions, scoped Mach-1 keys and native workforce integrations.
- [Errors](https://docs.aioncx.com/api-reference/errors.md): Design resilient clients while the Atlas v1 error contract is finalized.
- [List executable published Definition versions](https://docs.aioncx.com/api-reference/discovery/list-executable-published-definition-versions.md): List published analysis Definition versions available for direct submission.
- [List or discover authorized interactions](https://docs.aioncx.com/api-reference/interactions/list-or-discover-authorized-interactions.md): Identifier filters are mutually exclusive. An external ID may match multiple source actors or connections. A filtered cursor is bound to these filters.
- [Read authorized status](https://docs.aioncx.com/api-reference/interactions/read-authorized-status.md): Read the processing status for an authorized interaction. Reads may return lossless parts with next_cursor when large. Cursors pin input and transcript revisions. Native Zoom additionally requires recording visibility.
- [Read authorized transcript](https://docs.aioncx.com/api-reference/interactions/read-authorized-transcript.md): Read the speaker-attributed transcript for an authorized interaction. Reads may return lossless parts with next_cursor when large. Cursors pin input and transcript revisions. Native Zoom additionally requires recording visibility.
- [Read authorized results](https://docs.aioncx.com/api-reference/interactions/read-authorized-results.md): Read analysis results for an authorized interaction. Reads may return lossless parts with next_cursor when large. Cursors pin input and transcript revisions. Native Zoom additionally requires recording visibility.
- [Read authorized recording](https://docs.aioncx.com/api-reference/interactions/read-authorized-recording.md): Read recording details for an authorized interaction. Reads may return lossless parts with next_cursor when large. Cursors pin input and transcript revisions. Native Zoom additionally requires recording visibility.
- [Upload original audio](https://docs.aioncx.com/api-reference/direct-submission/upload-original-audio.md): Submit an original WAV, MP3, or M4A recording for asynchronous processing in the selected workspace.
- [Import a public audio URL](https://docs.aioncx.com/api-reference/direct-submission/import-a-public-audio-url.md): Submit a public audio URL for asynchronous ingestion in the selected workspace.
- [Submit existing text or turns](https://docs.aioncx.com/api-reference/direct-submission/submit-existing-text-or-turns.md): Submit existing transcript text or speaker turns for asynchronous analysis without uploading audio.
- [Forecasting REST API](https://docs.aioncx.com/api-reference/forecasting/overview.md): Submit a bounded Mach-1 forecast and retrieve its saved status and results using scoped forecast permissions.
- [Submit a numerical or registered-metric forecast](https://docs.aioncx.com/api-reference/submit-a-numerical-or-registered-metric-forecast.md): Requires forecast:submit. Retain the original payload and Idempotency-Key for uncertain retries. Request body limit: 1 MiB.
- [Read retained forecast status and results](https://docs.aioncx.com/api-reference/read-retained-forecast-status-and-results.md): Requires forecast:read and current source access. Follow next_cursor with the same quantile selection. Reads do not create another prediction run.
- [Workforce staffing to draft](https://docs.aioncx.com/api-reference/workforce/overview.md): The same native workforce operations through REST and MCP.
- [Discover workforce facts before WFM configuration](https://docs.aioncx.com/api-reference/discover-workforce-facts-before-wfm-configuration.md): Count-checked, read-only canonical Queue and membership inventory. Source, Person and semantic sections explicitly report denied or unavailable evidence. Summary returns totals and decisions; queue/person views return bounded detail pages after the same complete internal enumeration. No configuratio…
- [Inspect workforce configuration evidence](https://docs.aioncx.com/api-reference/inspect-workforce-configuration-evidence.md): Counts are configuration evidence only. queue_settings contains dated native queue service goals, currently sourced from Zoom catalog attributes, using count-checked pagination for all active queues. Missing or conflicting fields remain unknown. This does not establish observed performance, source f…
- [List scheduling groups](https://docs.aioncx.com/api-reference/list-scheduling-groups.md): List scheduling groups in the selected workspace.
- [Create a scheduling group atomically](https://docs.aioncx.com/api-reference/create-a-scheduling-group-atomically.md): Requires workforce write and current manage_schedules. Creates the native group and object together. Optional forecast_group_operation_key binds the latest reviewed forecast publication; a missing or superseded publication is refused.
- [Inspect scheduling group and roster](https://docs.aioncx.com/api-reference/inspect-scheduling-group-and-roster.md): Read a scheduling group's configuration and roster.
- [Read native schedule and activities](https://docs.aioncx.com/api-reference/read-native-schedule-and-activities.md): Read a saved native schedule and its activities.
- [Read staffing requirement evidence](https://docs.aioncx.com/api-reference/read-staffing-requirement-evidence.md): Read staffing requirement evidence for a scheduling group over the requested date range.
- [Evaluate staffing read-only](https://docs.aioncx.com/api-reference/evaluate-staffing-read-only.md): Requires ready source evidence; does not start a prediction or persist requirements. 1–14 inclusive dates.
- [Compute and persist staffing evidence](https://docs.aioncx.com/api-reference/compute-and-persist-staffing-evidence.md): Native recomputation, not a schedule commitment. Requires authored manual demand or completed forecast evidence; does not start inference. Staffing rows retain the latest computation; this operation is not an exactly-once staffing receipt.
- [Read compatible coverage evidence](https://docs.aioncx.com/api-reference/read-compatible-coverage-evidence.md): Read coverage evidence for a scheduling group over the requested date range.
- [Issue an exact native draft proposal](https://docs.aioncx.com/api-reference/issue-an-exact-native-draft-proposal.md): Persists issued request evidence; creates no shifts until commit. Requires usable authored demand and current requirements; unconfigured demand returns generation.demand_unavailable rather than a floor-only proposal. Maximum 14 dates and 200 roster entries. Native rules and source fencing remain aut…
- [Inspect native draft request](https://docs.aioncx.com/api-reference/inspect-native-draft-request.md): Read the state and evidence for a native draft request by its request key.
- [Commit issued draft exactly once](https://docs.aioncx.com/api-reference/commit-issued-draft-exactly-once.md): No body. Header key must equal path key. Rechecks current authority and native source revisions; identical replay returns the existing result. Does not publish.
- [Discover provider connections](https://docs.aioncx.com/api-reference/discover-provider-connections.md): Requires separate provider-read and current provider setup authority.
- [Inspect provider inventory](https://docs.aioncx.com/api-reference/inspect-provider-inventory.md): List resources from a selected workforce provider connection.
- [Inspect native configuration delivery evidence](https://docs.aioncx.com/api-reference/inspect-native-configuration-delivery-evidence.md): Read synchronization status and configuration delivery evidence for a workforce provider connection.
- [Inspect native calendar preparation](https://docs.aioncx.com/api-reference/inspect-native-calendar-preparation.md): Read native calendar preparation details for a workforce provider connection.
- [Inspect a scheduling group and members](https://docs.aioncx.com/api-reference/inspect-a-scheduling-group-and-members.md): Read a scheduling group and its member assignments.
- [Create a dated member atomically](https://docs.aioncx.com/api-reference/create-a-dated-member-atomically.md): Requires workforce write and current manage_workforce_roster. Subject is nested and never identifies the acting principal. Enforce mode requires employment_assignment_id. Validates current assignment, person, overlap and FTE; any needed Agent slot rolls back with a failed membership.
- [Inspect published forecast groups](https://docs.aioncx.com/api-reference/inspect-published-forecast-groups.md): List published forecast groups in the selected workspace, with optional archived groups.
- [Publish an authorized forecast configuration](https://docs.aioncx.com/api-reference/publish-an-authorized-forecast-configuration.md): Requires mcp:schedules:write and the explicit mcp:schedules:publish grant, plus the issuer’s current native and referenced-source authority. The same grant is rechecked when a saved setup assessment publishes a forecast configuration.
- [Inspect permissible owners, targets and calendars](https://docs.aioncx.com/api-reference/inspect-permissible-owners-targets-and-calendars.md): List permissible owners, targets, and calendars for forecast group configuration.
- [Validate proposed setup without configuration effects](https://docs.aioncx.com/api-reference/validate-proposed-setup-without-configuration-effects.md): At most 20 recommendations and 100 total members; bounded admission and a 20-second cooperative computation budget. Native validation determines createReady. Operational readiness remains not_verified. Returned commands and retry keys must be retained. forecastGroupKey links a scheduling recommendat…
- [Apply one exact saved native assessment command](https://docs.aioncx.com/api-reference/apply-one-exact-saved-native-assessment-command.md): The selected assessment must belong to this token owner in this workspace. Reads the command from existing Agent Kernel evidence; rejects configuration substitution. Each selected command already has a stable key, so no separate Idempotency-Key is used. Current native authority and assessment revisi…
- [Recover a native configuration result](https://docs.aioncx.com/api-reference/recover-a-native-configuration-result.md): Read-only lookup for this token Actor. Null is no confirmed result, not proof that a concurrent request failed. Does not create an Actor. A database/read failure is unknown and returns 503.
- [List the issuing Person’s ten latest setup sessions in this workspace](https://docs.aioncx.com/api-reference/list-the-issuing-person’s-ten-latest-setup-sessions-in-this-workspace.md): Lists the issuing Person’s ten latest setup runs in creation order within the selected workspace. Opening a run does not make it the newest. Closed runs are omitted.
- [Preflight or verify exact retained setup selections](https://docs.aioncx.com/api-reference/preflight-or-verify-exact-retained-setup-selections.md): Read-only. Preflight requires the current completed assessment and write grants; verification can recover old committed selections. Each check returns a current native record comparison. No Actor or receipt is created.
- [Read an owned retained assessment and its source-authorized conversation](https://docs.aioncx.com/api-reference/read-an-owned-retained-assessment-and-its-source-authorized-conversation.md): Current Person authority and source permissions are rechecked. resultRef selects a retained revision; after is a history cursor, not an evidence timestamp. Historical revisions are read-only. Missing source access hides the affected analysis. The token owner selects only their own conversation in th…
- [Delete the issuing Person’s setup run](https://docs.aioncx.com/api-reference/delete-the-issuing-person’s-setup-run.md): Requires workforce write and current manage_schedules authority. Closes only the token owner’s setup run in this workspace, attributes the request to its token Actor, then uses existing native conversation cleanup. Saved configuration, schedules and command receipts remain. An absent or foreign ID r…
- [Read native workforce intraday activity and provisional interval actuals](https://docs.aioncx.com/api-reference/read-native-workforce-intraday-activity-and-provisional-interval-actuals.md): Requires the existing workforce workspace grant, current manage_schedules transport authority, and native view_workforce_actual_activity capability. Returns the native scheduling-group intraday contract, with published schedule, canonical activity, adherence and observed interval facts. Raw provider…
- [Integrations overview](https://docs.aioncx.com/integrations/overview.md): Connect operational systems to the Atlas object and semantic model.
- [Callbacks and processing status](https://docs.aioncx.com/integrations/webhooks.md): Connect supported inbound deliveries and follow Mach-1 processing through the published status interfaces.
- [Model Context Protocol](https://docs.aioncx.com/integrations/mcp.md): Connect agents to Mach-1 processing or native Atlas workforce tools.
- [Mastra agent example](https://docs.aioncx.com/mach1/mastra.md): Connect a runnable Mach-1 client and discover tools available to its scoped credential.
- [Atlas primitives](https://docs.aioncx.com/concepts/overview.md): The small set of concepts behind Atlas decision intelligence.
- [Objects](https://docs.aioncx.com/concepts/objects.md): Durable, typed records for the things Atlas knows about.
- [Identities](https://docs.aioncx.com/concepts/identities.md): Resolve source-system keys to durable Atlas records.
- [Lists and Cycles](https://docs.aioncx.com/concepts/lists-and-cycles.md): Organize objects into governed collections and staged workflows.
- [Semantic layer](https://docs.aioncx.com/concepts/semantic-layer.md): Define business meaning once for analytics, decisions, and agents.
- [Build your first integration](https://docs.aioncx.com/guides/build-your-first-integration.md): Take an Atlas integration from discovery to a safe production launch.
- [Model your domain](https://docs.aioncx.com/guides/model-your-domain.md): Turn operational vocabulary into durable Atlas objects and semantics.
- [Changelog](https://docs.aioncx.com/changelog.md): Updates to the Atlas developer platform and its contracts.

## OpenAPI Specs

- [openapi](/api-reference/forecasting/openapi.json)
- [openapi](/api-reference/mach1/openapi.json)
- [openapi](/api-reference/workforce/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.