> ## Documentation Index
> Fetch the complete documentation index at: https://docs.continuouslabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Advance Simulation Time

> Schedules an absolute clock advance. Each successful advance commits all due local events in one step. World members advance through their World. Poll the returned operation until it completes.



## OpenAPI

````yaml /openapi/simulation.yaml post /v1/simulations/{id}/advance-time
openapi: 3.1.0
info:
  description: >-
    Build Simulators from OpenAPI or WSDL documents, create Simulations from
    them, and build Worlds that run Simulations together. Authenticate every
    request with an API key sent as a Bearer token.
  title: Continuous Simulation API
  version: v1
servers:
  - description: Continuous production API.
    url: https://api.continuouslabs.ai
security: []
tags:
  - description: >-
      Build Simulators from OpenAPI or WSDL documents, check or cancel a build,
      and delete Simulators.
    name: simulators
    x-group: Simulators
  - description: >-
      Create Simulations from ready Simulators, then fork, stop, start, and
      delete them.
    name: simulations
    x-group: Simulations
  - description: >-
      Build Worlds from one or more Simulators and start or stop their
      Simulations together.
    name: worlds
    x-group: Worlds
paths:
  /v1/simulations/{id}/advance-time:
    post:
      tags:
        - simulations
      summary: Advance Simulation Time
      description: >-
        Schedules an absolute clock advance. Each successful advance commits all
        due local events in one step. World members advance through their World.
        Poll the returned operation until it completes.
      operationId: advance-simulation
      parameters:
        - description: Simulation ID.
          in: path
          name: id
          required: true
          schema:
            pattern: ^sim_[0-9A-HJKMNP-TV-Z]{26}$
            type: string
        - description: >-
            Stable key for this request. Reuse with the same target returns the
            same operation.
          in: header
          name: Idempotency-Key
          required: true
          schema:
            maxLength: 256
            minLength: 1
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdvanceTimeRequest'
        required: true
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClockAdvance'
          description: Accepted
        '400':
          content:
            application/problem+json:
              examples:
                bad_request_body:
                  $ref: '#/components/examples/bad_request_body'
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          content:
            application/problem+json:
              examples:
                auth_forbidden_simulation:
                  $ref: '#/components/examples/auth_forbidden_simulation'
              schema:
                $ref: '#/components/schemas/Error'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              examples:
                simulation_not_found:
                  $ref: '#/components/examples/simulation_not_found'
              schema:
                $ref: '#/components/schemas/Error'
          description: Not Found
        '408':
          $ref: '#/components/responses/RequestTimeout'
        '409':
          content:
            application/problem+json:
              examples:
                clock_conflict:
                  $ref: '#/components/examples/clock_conflict'
                simulation_platform_owned:
                  $ref: '#/components/examples/simulation_platform_owned'
                simulation_stopped:
                  $ref: '#/components/examples/simulation_stopped'
                simulation_world_owned:
                  $ref: '#/components/examples/simulation_world_owned'
              schema:
                $ref: '#/components/schemas/Error'
          description: Conflict
        '413':
          $ref: '#/components/responses/PayloadTooLarge'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '422':
          content:
            application/problem+json:
              examples:
                validation_clock_time:
                  $ref: '#/components/examples/validation_clock_time'
              schema:
                $ref: '#/components/schemas/Error'
          description: Unprocessable Entity
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          content:
            application/problem+json:
              examples:
                auth_provider_unavailable:
                  $ref: '#/components/examples/auth_provider_unavailable'
                internal_unavailable:
                  $ref: '#/components/examples/internal_unavailable'
              schema:
                $ref: '#/components/schemas/Error'
          description: Service Unavailable
      security:
        - apiKeyAuth: []
components:
  schemas:
    AdvanceTimeRequest:
      additionalProperties: false
      properties:
        to:
          description: >-
            Absolute target time in RFC 3339, with at most millisecond
            precision.
          format: date-time
          type: string
      required:
        - to
      type: object
    ClockAdvance:
      additionalProperties: false
      properties:
        error:
          $ref: '#/components/schemas/ResourceError'
          description: Safe execution failure, or null when no failure is recorded.
        event_count:
          description: Number of committed event executions.
          format: int64
          minimum: 0
          type: integer
        from:
          description: Clock before the requested advance.
          format: date-time
          type: string
        id:
          description: Stable clock advance operation ID.
          pattern: ^adv_[0-9A-HJKMNP-TV-Z]{26}$
          type: string
        members:
          description: Progress for each participating Simulation.
          items:
            $ref: '#/components/schemas/ClockAdvanceMember'
          type: array
        status:
          description: Durable operation state. Poll while pending or running.
          enum:
            - pending
            - running
            - completed
            - failed
          type: string
        step:
          description: Committed local step, or null for no change or a World operation.
          format: int64
          type:
            - integer
            - 'null'
        to:
          description: Requested absolute target time.
          format: date-time
          type: string
      required:
        - id
        - status
        - from
        - to
        - event_count
        - step
        - members
        - error
      type: object
    Error:
      additionalProperties: false
      properties:
        code:
          description: Stable machine-readable error code.
          minLength: 1
          type: string
        detail:
          description: Safe human-readable error detail.
          minLength: 1
          type: string
        validation:
          $ref: '#/components/schemas/SpecificationValidation'
          description: >-
            Safe specification diagnostics for a rejected build request, when
            available.
      required:
        - validation
        - code
        - detail
      type: object
    ResourceError:
      additionalProperties: false
      properties:
        code:
          description: Stable machine-readable error code.
          type: string
        detail:
          description: Safe human-readable error detail.
          type: string
      required:
        - code
        - detail
      type:
        - object
        - 'null'
    ClockAdvanceMember:
      additionalProperties: false
      properties:
        error:
          $ref: '#/components/schemas/ResourceError'
          description: Safe execution failure, or null when no failure is recorded.
        event_count:
          description: Number of committed event executions.
          format: int64
          minimum: 0
          type: integer
        simulation_id:
          description: Member Simulation ID.
          pattern: ^sim_[0-9A-HJKMNP-TV-Z]{26}$
          type: string
        status:
          description: >-
            Whether this member is pending, committed, failed, or skipped
            because it is not running.
          enum:
            - pending
            - completed
            - failed
            - skipped
          type: string
        step:
          description: Committed local step, or null for no change or a failed advance.
          format: int64
          type:
            - integer
            - 'null'
      required:
        - simulation_id
        - status
        - event_count
        - step
        - error
      type: object
    SpecificationValidation:
      additionalProperties: false
      properties:
        issues:
          description: Specification validation problems. At most 20 are returned.
          items:
            $ref: '#/components/schemas/SpecificationIssue'
          maxItems: 20
          type: array
      required:
        - issues
      type:
        - object
        - 'null'
    SpecificationIssue:
      additionalProperties: false
      properties:
        code:
          description: Stable validation rule code.
          type: string
        kind:
          description: >-
            Whether the input is invalid, unsupported, incomplete, or has no
            specific diagnosis.
          enum:
            - invalid
            - unsupported
            - incomplete
            - unknown
          type: string
        location:
          description: Readable endpoint or field affected by this issue.
          maxLength: 512
          type: string
        message:
          description: What needs attention at this location.
          type: string
        operation:
          description: >-
            Affected operation ID or method and path, when available. Empty for
            document-level issues.
          maxLength: 243
          type: string
        suggestion:
          description: How to correct or address the problem.
          type: string
      required:
        - code
        - operation
        - location
        - kind
        - message
        - suggestion
      type: object
  examples:
    bad_request_body:
      value:
        code: bad_request
        detail: request body is invalid
        validation: null
    auth_forbidden_simulation:
      value:
        code: auth_forbidden
        detail: >-
          The Simulation with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6" belongs to
          another workspace.
        validation: null
    simulation_not_found:
      value:
        code: simulation_not_found
        detail: No Simulation was found with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6".
        validation: null
    clock_conflict:
      value:
        code: clock_conflict
        detail: A clock advance is active.
        validation: null
    simulation_platform_owned:
      value:
        code: simulation_platform_owned
        detail: >-
          The Simulation with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6" is in use by
          the platform and cannot be changed.
        validation: null
    simulation_stopped:
      value:
        code: simulation_stopped
        detail: >-
          The Simulation with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6" is stopped.
          Start it before you retry this request.
        validation: null
    simulation_world_owned:
      value:
        code: simulation_world_owned
        detail: >-
          The Simulation with ID "sim_01J8Z5X4K7M2N9P0Q1R2S3T4V6" belongs to the
          World with ID "wld_01J8Z5X4K7M2N9P0Q1R2S3T4V7". Manage it through the
          World.
        validation: null
    validation_clock_time:
      value:
        code: validation
        detail: >-
          time must be after 0001-01-01T00:00:00Z and before year 10000, with at
          most millisecond precision
        validation: null
    auth_provider_unavailable:
      value:
        code: auth_provider_unavailable
        detail: >-
          The authentication provider is unavailable. Retry the request after a
          short delay.
        validation: null
    internal_unavailable:
      value:
        code: internal_unavailable
        detail: >-
          The service is temporarily unavailable. Retry the request after a
          short delay.
        validation: null
    auth_invalid:
      value:
        code: auth_invalid
        detail: The authentication credential is invalid.
        validation: null
    auth_missing:
      value:
        code: auth_invalid
        detail: Authentication credentials are required.
        validation: null
    request_timeout:
      value:
        code: request_timeout
        detail: >-
          The request body was not received before the timeout. Retry the
          request.
        validation: null
    payload_too_large:
      value:
        code: payload_too_large
        detail: The request body exceeds the maximum allowed size.
        validation: null
    unsupported_media_type:
      value:
        code: unsupported_media_type
        detail: The request Content-Type is not supported.
        validation: null
    internal:
      value:
        code: internal
        detail: The server encountered an unexpected error.
        validation: null
  responses:
    Unauthorized:
      content:
        application/problem+json:
          examples:
            auth_invalid:
              $ref: '#/components/examples/auth_invalid'
            auth_missing:
              $ref: '#/components/examples/auth_missing'
          schema:
            $ref: '#/components/schemas/Error'
      description: Unauthorized
    RequestTimeout:
      content:
        application/problem+json:
          examples:
            request_timeout:
              $ref: '#/components/examples/request_timeout'
          schema:
            $ref: '#/components/schemas/Error'
      description: Request Timeout
    PayloadTooLarge:
      content:
        application/problem+json:
          examples:
            payload_too_large:
              $ref: '#/components/examples/payload_too_large'
          schema:
            $ref: '#/components/schemas/Error'
      description: Request Entity Too Large
    UnsupportedMediaType:
      content:
        application/problem+json:
          examples:
            unsupported_media_type:
              $ref: '#/components/examples/unsupported_media_type'
          schema:
            $ref: '#/components/schemas/Error'
      description: Unsupported Media Type
    InternalServerError:
      content:
        application/problem+json:
          examples:
            internal:
              $ref: '#/components/examples/internal'
          schema:
            $ref: '#/components/schemas/Error'
      description: Internal Server Error
  securitySchemes:
    apiKeyAuth:
      bearerFormat: Continuous API key
      description: >-
        Use a Continuous API key. Send it in the Authorization header as a
        Bearer token.
      scheme: bearer
      type: http

````