> ## 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. # Read native workforce intraday activity and provisional interval actuals > 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 fields additionally require view_workforce_activity_raw. Active interval actuals are provisional, and unknown source completeness is explicit. ## OpenAPI ````yaml /api-reference/workforce/openapi.json get /api/v1/workforce/scheduling-groups/{groupId}/intraday 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/scheduling-groups/{groupId}/intraday: get: summary: Read native workforce intraday activity and provisional interval actuals description: >- 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 fields additionally require view_workforce_activity_raw. Active interval actuals are provisional, and unknown source completeness is explicit. operationId: get_workforce_intraday 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: groupId in: path required: true schema: type: string format: uuid - name: date in: query required: false schema: type: string format: date description: Scheduling-group local calendar date. Defaults to group-local today. - name: history in: query required: false schema: type: string enum: - deferred description: >- deferred omits historical activity reads while retaining current state and interval metadata. MCP uses include_history=false. responses: '200': description: >- Native evidence or exact command result. Unavailable evidence is explicitly labeled. content: application/json: schema: $ref: '#/components/schemas/WorkforceIntraday' '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' '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: WorkforceIntraday: type: object required: - group - date - generated_at - requirement - schedule_references - intervals - forecast_actuals - now - agents - present_available - warnings properties: group: type: object properties: id: type: string format: uuid name: type: string timezone: type: string slot_minutes: type: number date: type: string format: date generated_at: type: string format: date-time requirement: type: - object - 'null' properties: computed_at: type: - string - 'null' mode: type: - string - 'null' stale: type: boolean schedule_references: type: array items: type: object intervals: type: array items: type: object properties: required: type: - number - 'null' scheduled_headcount: type: - number - 'null' scheduled_people: type: - number - 'null' scheduled_person_seconds: type: - number - 'null' scheduled_productive_headcount: type: - number - 'null' scheduled_productive_people: type: - number - 'null' productive_person_seconds: type: - number - 'null' present_headcount: type: - number - 'null' present_people: type: - number - 'null' present_person_seconds: type: - number - 'null' start_minute: type: number end_minute: type: number start_ts: type: string format: date-time end_ts: type: string format: date-time present_evidence: type: string enum: - complete - partial - unknown - unavailable - pending observation: type: object required: - phase - status - elapsed_seconds - remaining_seconds - observed_through - stabilized_through - observed_seconds properties: phase: type: string enum: - future - active - closed status: type: string enum: - pending - provisional - final - unavailable elapsed_seconds: type: number minimum: 0 remaining_seconds: type: number minimum: 0 observed_through: type: - string - 'null' stabilized_through: type: - string - 'null' observed_seconds: type: - number - 'null' forecast_actuals: type: array items: type: object properties: run_id: type: string metric_ref: type: string grain: type: string timezone: type: string dimension_key: type: object interval_start_ts: type: string format: date-time interval_end_ts: type: string format: date-time forecast_full_interval: type: number actual_so_far: type: - number - 'null' requested_through_ts: type: - string - 'null' observed_through_ts: type: - string - 'null' source_completeness: type: string phase: type: string enum: - future - active - closed final: const: false target_object_type: type: string target_object_id: type: - string - 'null' metric_label: type: - string - 'null' description: >- Live semantic comparison at the original forecast grain and timezone. It never finalizes a PredictionActualService record. observed_through_ts remains null when the semantic source does not publish a trustworthy cutoff. now: type: - object - 'null' description: >- Native current-state staffing and adherence facts, present only for group-local today. agents: type: array items: type: object description: >- Native scoped Agent and Person identities, published scheduled activity, canonical current activity, source evidence and adherence. raw_status and raw_substatus are withheld without native raw capability. present_available: type: boolean warnings: type: array items: type: string 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.