Skip to main content
GET
/
run
/
{session_id}
Retrieve run results
curl --request GET \
  --url https://api.cloudcruise.com/run/{session_id} \
  --header 'cc-key: <api-key>'
{
  "session_id": "e5f6a7b8-9abc-4def-0123-56789abcdef0",
  "status": "execution.success",
  "workflow_id": "d4e5f6a7-89ab-45cd-ef01-456789012abc",
  "input_variables": {},
  "vault_entries": {},
  "encrypted_variables": [
    "<string>"
  ],
  "session_retries": 123,
  "data": {
    "your_defined_datamodel": "example_value"
  },
  "video_urls": [
    {
      "timestamp": "2024-01-01T00:00:00.000000+00:00",
      "session_id": "e5f6a7b8-9abc-4def-0123-56789abcdef0",
      "signed_screen_recording_url": "https://www.example.com/screen-recording.mp4",
      "signed_screen_recording_url_expires": "2024-01-08T00:00:00.000000+00:00"
    }
  ],
  "file_urls": [
    {
      "signed_file_url": "https://www.example.com/file.csv",
      "file_name": "file.csv",
      "timestamp": "2025-06-04T20:45:11.669Z",
      "signed_file_url_expires": "2025-06-11T20:45:11.669Z",
      "metadata": {}
    }
  ],
  "screenshot_urls": [
    {
      "signed_screenshot_url": "https://www.example.com/screenshot.png",
      "node_display_name": "Button",
      "timestamp": "2024-01-01T00:00:00.000000+00:00",
      "signed_screenshot_url_expires": "2024-01-01T00:00:00.000000+00:00",
      "error_screenshot": false
    }
  ],
  "errors": [
    {
      "message": "Button not found",
      "error_id": "7c8d9e0f-1a2b-4c3d-8e5f-6a7b8c9d0e1f",
      "full_url": "https://www.example.com/current-page",
      "llm_error_description": "The login button selector did not match any element.",
      "created_at": "2024-01-01T00:00:00.000000+00:00",
      "error_code": "ERR-0001",
      "action_type": "CLICK",
      "action_display_name": "Click on the confirm button",
      "original_error": "Element not found: //button[@id='login-submit']",
      "llm_error_category": "AUTHENTICATION_ERROR",
      "llm_error_sub_type": "INVALID_CREDENTIALS",
      "node_id": "9f8e7d6c-5b4a-4321-9edc-ba9876543210",
      "input_recovery": {},
      "password_update_recovery": {}
    }
  ],
  "was_recovered": true,
  "recovered_error_ids": [
    "<string>"
  ]
}
This endpoint is subject to global rate limits. For real-time updates without polling, consider using webhooks or our SDKs instead.
The response includes recovery information when errors were automatically resolved during the run:
  • was_recovered — true if any errors were successfully recovered by the Maintenance Agent
  • recovered_error_ids — array of error_id values that were recovered, correlating to the errors array
Each error object also includes llm_error_sub_type (the specific sub‑classification) and llm_error_description (an AI‑generated explanation of the failure). See the error classification matrix for all possible category and sub‑type values.

Authorizations

​
cc-key
string
header
required

API key-based authentication. Provide your CloudCruise API key in the cc-key header.

Path Parameters

​
session_id
string
required

Unique identifier for the browser agent run session

Response

Run results successfully retrieved

Comprehensive response containing workflow execution results and artifacts

​
session_id
string

Unique identifier for the workflow execution session (UUIDv4)

Example:

"e5f6a7b8-9abc-4def-0123-56789abcdef0"

​
status
enum<string>

Current status of the workflow execution

Available options:
execution.queued,
execution.start,
execution.failed,
execution.success,
execution.paused,
execution.stopped,
execution.requeued
Example:

"execution.success"

​
workflow_id
string<uuid> | null

Identifier for the workflow that was executed

Example:

"d4e5f6a7-89ab-45cd-ef01-456789012abc"

​
input_variables
Input Variables · object

Variables provided at workflow execution start. Contains both workflow-specific inputs and vault entry references.

Vault entries are referenced by their permissioned_user_id, either as single strings or arrays for credential pooling.

​
vault_entries
Vault Entries · object

Vault entry metadata for credentials used in this run. Keys are the credential aliases defined in the workflow's vault_schema. Values contain the user ID, alias, domain, and encrypted credentials.

​
encrypted_variables
string[] | null

List of input variable keys whose values are encrypted vault credentials. Use this to identify which input_variables contain sensitive data that should not be displayed in plaintext.

​
session_retries
integer | null

Number of times this run has been retried due to recoverable errors (e.g., service unavailable). Null if the run has not been retried.

​
data
object

Output data from the workflow execution, structured according to your defined data model

​
video_urls
object[]
​
file_urls
object[]
​
screenshot_urls
object[]
​
errors
Errors · object[] | null

List of errors encountered during workflow execution

​
was_recovered
boolean | null

Whether any errors in this run were successfully recovered by the Maintenance Agent. True if at least one error was auto-recovered.

​
recovered_error_ids
string[] | null

Array of error_id values from the errors array that were successfully auto-recovered by the Maintenance Agent.