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": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "execution.success",
  "workflow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "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": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "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": [
    {
      "prompt": "Search for a button to confirm the input form",
      "message": "Button not found",
      "error_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "full_url": "https://www.example.com/current-page",
      "llm_model": "gpt-x",
      "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"
    }
  ]
}
This endpoint is subject to global rate limits. For real-time updates without polling, consider using webhooks or our SDKs instead.

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:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

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:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

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