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

# Get debug snapshots

> Retrieves debug snapshots for a specific node in a workflow run. This endpoint is only available for runs started with `debug: true`. It returns:
- An HTML page snapshot captured at the time the node was executed
- Any screenshots taken at that node

The HTML snapshot contains the full DOM state of the page, including inlined iframe content. Signed URLs are valid for 1 hour.



## OpenAPI

````yaml run-api/run-api.yaml get /run/{session_id}/debug-snapshots/{node_id}
openapi: 3.1.0
info:
  title: CloudCruise Run API
  version: 0.1.0
  description: >-
    Endpoints for managing workflow executions, user interactions, and
    retrieving execution results.
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /run/{session_id}/debug-snapshots/{node_id}:
    get:
      summary: Get debug snapshots
      description: >-
        Retrieves debug snapshots for a specific node in a workflow run. This
        endpoint is only available for runs started with `debug: true`. It
        returns:

        - An HTML page snapshot captured at the time the node was executed

        - Any screenshots taken at that node


        The HTML snapshot contains the full DOM state of the page, including
        inlined iframe content. Signed URLs are valid for 1 hour.
      operationId: get_debug_snapshots
      parameters:
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: Unique identifier for the workflow execution session
        - name: node_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: Unique identifier for the workflow node
      responses:
        '200':
          description: Debug snapshots successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DebugSnapshotsResponse'
        '404':
          description: Session not found or node has no snapshots
components:
  schemas:
    DebugSnapshotsResponse:
      type: object
      description: Debug snapshot data for a specific node in a workflow run
      properties:
        session_id:
          type: string
          format: uuid
          example: e5f6a7b8-9abc-4def-0123-56789abcdef0
          description: Unique identifier for the workflow execution session
        node_id:
          type: string
          format: uuid
          example: 9f8e7d6c-5b4a-4321-9edc-ba9876543210
          description: Unique identifier for the workflow node
        page_snapshot_url:
          type: string
          format: uri
          nullable: true
          example: >-
            https://storage.example.com/page_snapshots/workspace/workflow/node/session.html?token=...
          description: >-
            Signed URL to the HTML page snapshot captured when this node was
            executed. Contains the full DOM state including inlined iframe
            content. Valid for 1 hour. Null if no snapshot was captured.
        screenshots:
          type: array
          description: Screenshots taken at this node during execution
          items:
            type: object
            properties:
              screenshot_id:
                type: string
                format: uuid
                example: aabbccdd-eeff-4001-8899-112233445566
                description: Unique identifier for the screenshot
              signed_screenshot_url:
                type: string
                format: uri
                example: >-
                  https://storage.example.com/screenshots/workspace/session/screenshot.jpeg?token=...
                description: Signed URL to the screenshot image. Valid for 1 hour.
              node_display_name:
                type: string
                example: Click Login Button
                description: Display name of the workflow node
              node_id:
                type: string
                format: uuid
                example: 9f8e7d6c-5b4a-4321-9edc-ba9876543210
                description: Unique identifier for the workflow node
              timestamp:
                type: string
                format: date-time
                example: '2026-02-27T07:16:20.083Z'
                description: When the screenshot was captured
              signed_screenshot_url_expires:
                type: string
                format: date-time
                example: '2026-02-27T08:16:20.083Z'
                description: When the signed screenshot URL expires
              error_screenshot:
                type: boolean
                example: false
                description: Whether this screenshot was taken during an error state
      required:
        - session_id
        - node_id
        - page_snapshot_url
        - screenshots
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````