> ## 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. # Create a scheduling group atomically > 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. ## OpenAPI ````yaml /api-reference/workforce/openapi.json post /api/v1/workforce/scheduling-groups 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: post: summary: Create a scheduling group atomically description: >- 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. operationId: create_scheduling_group 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: Idempotency-Key in: header required: true schema: type: string format: uuid description: Retain the exact key and body across retries and transports. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SchedulingGroupCreate' responses: '200': description: >- Authorized native result. Configuration success does not establish operational readiness. content: application/json: schema: $ref: '#/components/schemas/ConfigurationReceipt' '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: SchedulingGroupCreate: type: object properties: name: type: string minLength: 1 maxLength: 120 timezone: type: string operating_open: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$ operating_close: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$ slot_minutes: default: 30 type: integer minimum: 1 maximum: 240 allowed_max_ooo_pct: default: 100 type: number exclusiveMinimum: 0 maximum: 100 ceiling_profile: default: null anyOf: - type: object propertyNames: type: string enum: - mon - tue - wed - thu - fri - sat - sun additionalProperties: type: number exclusiveMinimum: 0 maximum: 100 - type: 'null' minimum_floor: default: null anyOf: - type: number minimum: 0 - type: 'null' warn_threshold: default: null anyOf: - type: number minimum: 0 maximum: 100 - type: 'null' include_pending: default: true type: boolean operating_profile: default: null anyOf: - type: object propertyNames: type: string enum: - mon - tue - wed - thu - fri - sat - sun additionalProperties: type: object properties: open: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$ close: type: string pattern: ^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$ closed: type: boolean required: - open - close - closed additionalProperties: false - type: 'null' default_forecast_group_id: default: null 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' forecast_group_operation_key: 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' request_key: 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)$ expected_forecast_revision: type: integer minimum: 1 description: >- Expected current revision when linking an existing forecast group. Setup preview captures this automatically. required: - name - timezone - operating_open - operating_close additionalProperties: false ConfigurationReceipt: type: object properties: outcome: const: committed replayed: type: boolean request_key: type: string format: uuid record_id: type: string format: uuid request: type: object description: >- Immutable original actor, person, kind, parent and configuration evidence. record: type: object description: >- Current native group or membership row; the original request is retained separately. required: - outcome - replayed - request_key - record_id - request - record 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.