> ## 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. # List API Box Snapshots > Returns the workspace's API Box Snapshots and the catalog's, newest first. Results can be filtered by source and status. ## OpenAPI ````yaml /openapi/simulation.yaml get /v1/apibox-snapshots openapi: 3.1.0 info: description: >- Start API Boxes, Web Boxes, MCP Boxes and Cloud Boxes from Snapshots. Authenticate every request with an API key sent as a Bearer token. title: Continuous API version: v1 servers: - description: Continuous production API. url: https://api.continuouslabs.ai security: [] tags: - description: >- Start API Boxes from API Box Snapshots. Each API Box serves its Snapshot's API at its own endpoint, with its own state, in real time. Stop, start and delete them. name: apibox x-group: API Boxes - description: >- Build API Box Snapshots from an OpenAPI, WSDL or GraphQL document, or use the catalog's. API Boxes start from a ready Snapshot. name: apibox-snapshots x-group: API Box Snapshots - description: >- Start Web Boxes from Web Box Snapshots. Each Web Box serves its Snapshot's web app at a host of its own, with its own state, in real time. Stop, start and delete them. name: webbox x-group: Web Boxes - description: >- Build Web Box Snapshots from a vendor's live web app, or use the catalog's. Web Boxes start from a ready Snapshot. name: webbox-snapshots x-group: Web Box Snapshots - description: >- Start MCP Boxes from MCP Box Snapshots. Each MCP Box serves its Snapshot's tools over MCP in front of an API Box. Stop, start and delete them. name: mcpbox x-group: MCP Boxes - description: >- List, rename and delete the MCP Box Snapshots that Continuous publishes into your workspace. Each holds an MCP server's tools, built against an API Box Snapshot. name: mcpbox-snapshots x-group: MCP Box Snapshots - description: >- Create emulated cloud accounts from Cloud Box Snapshots, start and stop them, and manage their Keys and connections. name: cloudbox x-group: Cloud Boxes - description: >- Save a Cloud Box's state as a Snapshot that new Cloud Boxes start from, and inspect, rename or delete Snapshots. name: cloudbox-snapshots x-group: Cloud Box Snapshots - description: >- Deprecated. Use API Box for APIs and Web Box for web apps. Build Simulators from OpenAPI, WSDL or GraphQL documents, check or cancel a build, clone Simulators into other workspaces, and rename and delete Simulators. name: simulators x-group: Simulators - description: >- Deprecated. Use API Box for APIs and Web Box for web apps. Create Simulations from ready Simulators or Snapshots, then rename, stop, start, and delete them. name: simulations x-group: Simulations - description: >- Deprecated. Use API Box for APIs and Web Box for web apps. Save a running Simulation's state as a Snapshot, create Simulations from it, and rename and delete it. name: simulation-snapshots x-group: Simulation Snapshots - description: >- Store connections to real systems: a base URL, the header that carries the credential, and its value. The API never returns a value. name: credentials x-group: Credentials paths: /v1/apibox-snapshots: get: tags: - apibox-snapshots summary: List API Box Snapshots description: >- Returns the workspace's API Box Snapshots and the catalog's, newest first. Results can be filtered by source and status. operationId: list-apibox-snapshots parameters: - description: Optional build status filter. explode: false in: query name: status schema: enum: - pending - building - ready - failed - canceled type: string - description: Page size. Values below 1 use 50. Values above 200 use 200. explode: false in: query name: limit schema: default: 50 format: int64 type: integer - description: Opaque next_cursor value from a previous page. explode: false in: query name: cursor schema: type: string - description: Optional source filter. explode: false in: query name: source schema: enum: - catalog - build type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListAPIBoxSnapshotsResponse' description: OK '400': content: application/problem+json: examples: bad_request: $ref: '#/components/examples/bad_request' schema: $ref: '#/components/schemas/Error' description: Bad Request '401': $ref: '#/components/responses/Unauthorized' '422': content: application/problem+json: examples: validation_list_limit: $ref: '#/components/examples/validation_list_limit' 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: ListAPIBoxSnapshotsResponse: additionalProperties: false properties: next_cursor: description: Cursor for the next page, or null. type: - string - 'null' snapshots: description: API Box Snapshots in this page. items: $ref: '#/components/schemas/APIBoxSnapshot' type: array required: - snapshots - next_cursor 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 APIBoxSnapshot: additionalProperties: false properties: build: description: >- The build's latest progress report, or null before the first report. A settled Snapshot keeps its last report. A build waiting for its live credentials resumes with POST /v1/apibox-snapshots/{id}/resume. oneOf: - $ref: '#/components/schemas/SimulatorBuildProgress' - type: 'null' composition: description: What a ready Snapshot serves, or null. oneOf: - $ref: '#/components/schemas/SimulatorComposition' - type: 'null' created_at: description: Snapshot creation time. format: date-time type: string credential_ids: description: >- Workspace credentials the build was allowed to call real systems with. Empty when none. items: type: string type: array error: $ref: '#/components/schemas/SimulatorError' description: Why the build failed or was canceled, or null. hidden_limitations: description: Limitations the Snapshot records beyond those listed in limitations. format: int64 minimum: 0 type: integer id: description: API Box Snapshot ID. pattern: ^abs_[0-9A-HJKMNP-TV-Z]{26}$ type: string instructions: description: The instructions the build followed, or empty when none were given. type: string limitations: description: >- Behavior the Snapshot does not serve like the real system, most important first, whether it was built or published. Empty when none. items: $ref: '#/components/schemas/Limitation' type: array metadata: description: Customer JSON metadata, or null. name: description: Snapshot name. The ID is its identity, and names need not be unique. maxLength: 128 type: string research: description: The build's research stage, or null when research did not run. oneOf: - $ref: '#/components/schemas/SimulatorResearch' - type: 'null' source: description: >- catalog for a Snapshot Continuous publishes, build for one built or published into the workspace. enum: - catalog - build type: string spec_kind: description: >- The specification the Snapshot was built from, or null until the build has read it. enum: - openapi - wsdl - graphql - null type: - string - 'null' status: description: >- pending while waiting for capacity; building while the build runs; ready when API Boxes can start from it; failed when the build failed; canceled when a cancel request took effect. enum: - pending - building - ready - failed - canceled type: string required: - id - name - source - status - spec_kind - instructions - credential_ids - error - build - research - limitations - hidden_limitations - composition - metadata - created_at 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' SimulatorBuildProgress: additionalProperties: false properties: hidden_limitations: description: >- Limitations the accepted build records beyond those listed in limitations. format: int64 minimum: 0 type: integer last_submission: description: Outcome of the most recent submit attempt, or null. enum: - accepted - rejected - null type: - string - 'null' last_tool: description: >- Name of the most recent tool call, or null. Tool arguments and output are private. type: - string - 'null' limitations: description: >- Behavior the accepted build does not serve like the real system, most important first, set when the build is accepted. Empty when none. items: $ref: '#/components/schemas/Limitation' maxItems: 50 type: array model: description: >- The model the builder and reviewer run on, or combined, which currently runs as claude-opus-5-5. A build recorded before model selection reports its provider's default. enum: - gpt-6-astra - gpt-6.1-sol - claude-opus-5-5 - claude-fable-5-1 - gpt-6-sol - combined type: string phase: description: >- Agent phase: research while the research agent indexes the documents and saves the vendor pages they lack; build for generation, review for the separate reviewer, qa while QA tests the running Simulator from outside, after the last review round of a build with credential_ids, finalize for author repair after review or QA. Null when not recorded. enum: - research - build - review - qa - finalize - null type: - string - 'null' review_round: description: >- Review round that phase review, qa, or finalize belongs to, from 1. In a build with credential_ids, QA and the repair after it are in round review_rounds + 1. 0 before the first review. format: int64 maximum: 11 minimum: 0 type: integer review_rounds: description: >- Review rounds the build runs at most. Fewer run when the reviewer agrees early. format: int64 maximum: 10 minimum: 1 type: integer stage: description: >- derive while the effective spec, build skeleton, and sandbox are prepared; build while the coding loop runs; assemble while an accepted artifact publishes. enum: - derive - build - assemble type: string submissions: description: Submit attempts. format: int64 minimum: 0 type: integer tool_calls: description: Tool calls the coding loop executed. format: int64 minimum: 0 type: integer waited_seconds: description: >- Total seconds of the build's ended waits for its live credentials, which do not count toward its time limit. 0 when none has ended. The current wait, from waiting.since, is not included. format: int64 minimum: 0 type: integer waiting: description: >- Set while the build waits at QA because the live systems rejected its credentials; refresh them, then resume the build with its resource's resume operation, such as POST /v1/simulators/{id}/resume. Null otherwise. oneOf: - $ref: '#/components/schemas/SimulatorBuildWaiting' - type: 'null' warnings: description: >- Specification defects the build tolerated without changing the specification, set when the build prepares its specification. Empty when none. items: $ref: '#/components/schemas/SpecificationWarning' maxItems: 20 type: array required: - model - phase - review_round - review_rounds - stage - tool_calls - submissions - last_tool - last_submission - warnings - limitations - hidden_limitations - waited_seconds - waiting type: object SimulatorComposition: additionalProperties: false properties: entities: description: Entities that the Simulator stores. format: int64 type: integer operations: description: Operations that the Simulator routes. format: int64 type: integer sample: description: >- Whether the Simulator carries sample data that a new Simulation can start with. type: boolean required: - operations - entities - sample type: object SimulatorError: additionalProperties: false properties: agent_message: description: >- Plain-text explanation from the build agent when it could not continue, or the problems the check of the build's index found. At most 4096 UTF-8 bytes. maxLength: 4096 type: - string - 'null' code: description: >- Stable Simulator build error code. live_credential_rejected is a build that waited at QA for its rejected live credentials and was not resumed within 7 days. enum: - build_failed - build_canceled - specification_validation_failed - live_credential_rejected type: string detail: description: Safe human-readable error detail. type: string reason: description: >- Bounded failure reason for selecting recovery guidance, or null when unavailable. enum: - canceled - specification_invalid - time_limit - service_unavailable - build_failed - null type: - string - 'null' validation: $ref: '#/components/schemas/SpecificationValidation' description: >- Specification validation details. Address these issues before building again. required: - agent_message - reason - validation - code - detail type: - object - 'null' Limitation: additionalProperties: false properties: location: description: >- The operations the limitation affects, readably, or Simulator when it names none. maxLength: 512 type: string message: description: What the Simulator does differently from the real system. type: string operations: description: Operation IDs the limitation affects, or empty when it names none. items: type: string maxItems: 20 type: array reviewed: description: >- Whether review confirmed that the pinned contract or the scaffold cannot express the correct behavior. False for a limitation the build recorded after review or that review did not confirm. type: boolean required: - message - location - operations - reviewed type: object SimulatorResearch: additionalProperties: false properties: bytes: description: Total size of the saved pages in bytes. format: int64 minimum: 0 type: integer pages: description: Vendor pages research saved for the build. format: int64 minimum: 0 type: integer status: description: >- pending until the stage starts; running while the research agent indexes the documents and saves the vendor pages they lack; complete when it wrote an index that names every document; failed when it could not finish, which fails the build, or when the build ended first; provided when research did not run because the build already had an index. enum: - pending - running - complete - failed - provided type: string required: - status - pages - bytes type: object SpecificationIssue: additionalProperties: false properties: code: description: Stable validation rule code. type: string kind: description: >- Whether the input is invalid, unsupported, incomplete, exceeds a build limit, or has no specific diagnosis. enum: - invalid - unsupported - incomplete - limit - 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 SimulatorBuildWaiting: additionalProperties: false properties: credential_ids: description: >- The credentials to refresh with PATCH /v1/credentials/{id} before resuming the build. items: type: string type: array deadline: description: >- When the wait ends, 7 days after it began: a build not resumed by then fails with error code live_credential_rejected. The wait does not count toward the build's time limit. format: date-time type: string reason: description: >- Why the build waits: the status and detail of the live reply that rejected QA's authenticated read. type: string since: description: When the build started waiting. format: date-time type: string required: - reason - credential_ids - since - deadline type: object SpecificationWarning: additionalProperties: false properties: code: description: Stable warning code. enum: - spec.enum_duplicate - spec.path_parameter_optional - spec.default_invalid - spec.response_untyped - spec.schema_limit - spec.operation_unservable - spec.example_null type: string location: description: Readable endpoint or field affected by this warning. maxLength: 512 type: string message: description: What the specification declares and how the build handles it. type: string operations: description: Always empty. items: type: string maxItems: 0 type: array required: - code - location - message - operations type: object examples: bad_request: value: code: bad_request detail: The cursor is invalid. validation: null validation_list_limit: value: code: validation detail: 'validation failed: invalid integer at query.limit' 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 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 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.