> ## 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 Cloud Box Snapshots > Returns the Snapshots a Cloud Box can start from, the catalog's and the workspace's, newest first. ## OpenAPI ````yaml /openapi/simulation.yaml get /v1/cloudbox-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/cloudbox-snapshots: get: tags: - cloudbox-snapshots summary: List Cloud Box Snapshots description: >- Returns the Snapshots a Cloud Box can start from, the catalog's and the workspace's, newest first. operationId: list-cloudbox-snapshots parameters: - description: Optional filter for the Snapshots saved from this Cloud Box. explode: false in: query name: cloudbox_id schema: pattern: ^box_[0-9A-HJKMNP-TV-Z]{26}$ type: string - description: Optional status filter. explode: false in: query name: status schema: enum: - creating - ready - failed - unavailable type: string - description: Optional type filter, for example aws. explode: false in: query name: type schema: type: string - description: Optional source filter. explode: false in: query name: source schema: enum: - catalog - box 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 responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListCloudBoxSnapshotsResponse' 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: ListCloudBoxSnapshotsResponse: additionalProperties: false properties: cloudbox_snapshots: description: Snapshots in this page, newest first. items: $ref: '#/components/schemas/CloudBoxSnapshot' type: array next_cursor: description: Cursor for the next page, or null. type: - string - 'null' required: - cloudbox_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 CloudBoxSnapshot: additionalProperties: false properties: aliases: additionalProperties: type: string description: >- Short names for names in routes. Cloud Boxes started from the Snapshot resolve them. type: object cloudbox_id: description: >- ID of the Cloud Box a saved Snapshot captured, or null for the catalog and once that Cloud Box is deleted. pattern: ^box_[0-9A-HJKMNP-TV-Z]{26}$ type: - string - 'null' created_at: description: Snapshot creation time. format: date-time type: string digest: description: Digest of the catalog image under the Snapshot. pattern: ^sha256:[0-9a-f]{64}$ type: string id: description: Snapshot ID. pattern: ^bx[st]_[0-9A-HJKMNP-TV-Z]{26}$ type: string name: description: Snapshot name, for example aws for the catalog's empty account. maxLength: 128 type: string resources_recorded_at: description: >- When the resources inside the Cloud Box were recorded on the Snapshot, or null for the catalog and when they were not recorded. format: date-time type: - string - 'null' routes: description: >- Names inside the Cloud Box when the Snapshot was saved; empty for the catalog and for Snapshots saved before names were recorded. items: $ref: '#/components/schemas/CloudBoxSnapshotRoute' type: array source: description: >- catalog for a Snapshot Continuous publishes, box for one saved from a Cloud Box. enum: - catalog - box type: string status: description: >- creating while a save runs. A Cloud Box can start from a ready Snapshot. unavailable is a catalog Snapshot a newer revision replaced. enum: - creating - ready - failed - unavailable type: string type: description: >- Platform the Snapshot emulates. Cloud Boxes and Keys take their Snapshot's type. enum: - aws type: string x-speakeasy-unknown-values: allow required: - id - name - type - source - status - cloudbox_id - digest - routes - aliases - resources_recorded_at - 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' CloudBoxSnapshotRoute: additionalProperties: false properties: arn: description: ARN of the resource the name resolves to. type: string client_port: description: Port clients inside the Cloud Box call the name on. format: int64 maximum: 65535 minimum: 1 type: integer name: description: Name inside the Cloud Box. type: string resource_type: description: Type of the resource the name resolves to, for example rds. type: string required: - name - client_port - resource_type - arn 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 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.