> ## Documentation Index > Fetch the complete documentation index at: https://docs.aioncx.com/llms.txt > Use this file to discover all available pages before exploring further. # Explain an interval and inspect validated suggestions > Read-only. Returns original-grain demand and productive supply with one physical allocation per Person across groups, accounting, source-attributed findings, validated candidate suggestions and search limits. No found suggestion does not prove infeasibility. Apply a suggestion through the same draft edit lifecycle. ## OpenAPI ````yaml /api-reference/workforce/openapi.json post /api/v1/workforce/schedules/{scheduleId}/explain-interval openapi: 3.1.0 info: title: Atlas workforce API version: 2026-10-preview description: >- Authenticated workforce staffing-to-draft operations. Released together with matching MCP operations. Deploy the reviewed native guard migrations before enabling this feature. servers: - url: / security: - AtlasIntegrationBearer: [] paths: /api/v1/workforce/schedules/{scheduleId}/explain-interval: post: summary: Explain an interval and inspect validated suggestions description: >- Read-only. Returns original-grain demand and productive supply with one physical allocation per Person across groups, accounting, source-attributed findings, validated candidate suggestions and search limits. No found suggestion does not prove infeasibility. Apply a suggestion through the same draft edit lifecycle. operationId: explain_schedule_interval parameters: - name: X-Workspace-Id in: header required: true schema: type: string format: uuid description: >- Selector within saved grants and current issuer authority; never grants authority. - name: scheduleId in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WorkforceIntervalExplain' responses: '200': description: Native typed result. content: application/json: schema: $ref: '#/components/schemas/WorkforcePlanningResult' '400': description: Missing or malformed transport fields content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing, invalid or expired bearer content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Saved grant or current authority denied content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Scoped resource not found content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Stale source/revision or conflicting request content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: Body exceeds 64 KiB content: application/json: schema: $ref: '#/components/schemas/Error' '415': description: Content-Type must be application/json content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Invalid or unsupported input content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Concurrent compute limit; retry after 5 seconds content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: Required evidence or service unavailable content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: WorkforceIntervalExplain: type: object properties: base_updated_at: anyOf: - type: string minLength: 1 - type: 'null' shifts: maxItems: 5000 type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ person_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ employment_assignment_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' agent_object_record_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ start_ts: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ end_ts: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ template_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' template_revision: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' activities: maxItems: 100 type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ activity_type_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ activity_type_slug: type: string minLength: 1 maxLength: 100 start_ts: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ end_ts: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ is_locked: type: boolean source: type: string enum: - manual - template - rotation - generated - time_off_projection - system_adjustment source_ref_type: anyOf: - type: string maxLength: 100 - type: 'null' source_ref_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' occurrence_key: anyOf: - type: string maxLength: 300 - type: 'null' counts_productive: type: boolean is_time_off: type: boolean required: - start_ts - end_ts additionalProperties: false required: - id - person_id - employment_assignment_id - start_ts - end_ts - activities additionalProperties: false refresh_records: type: boolean start_ts: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ end_ts: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ suggest_fixes: default: true type: boolean required: - base_updated_at - shifts - start_ts - end_ts additionalProperties: false WorkforcePlanningResult: type: object description: >- Native typed outcome. Depending on the operation: records and effective revisions, `issues` with code, field path, severity and source references, applied constraints, soft preference effects, affected drafts and future published commitments with `complete`, missing or unsupported evidence, `replayed` for an exact retry and verified effect references. Authored availability, preference and pattern bodies round-trip unchanged. additionalProperties: true Error: type: object properties: error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - error additionalProperties: false securitySchemes: AtlasIntegrationBearer: type: http scheme: bearer bearerFormat: atlas_mcp_ description: >- Existing Atlas integration connection with explicit api:connect plus appropriate native domain grants. atlas_ingest_ and browser cookies are not accepted. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.