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",
  "input_variables": {},
  "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"
    }
  ]
}

​
Rate Limits

When polling for run results, please respect the following rate limits to avoid receiving 429 Too Many Requests errors:
Time WindowMax Requests
1 second500
15 seconds1,000
60 seconds2,000
Rate limits apply per API key or workspace. If you exceed these limits, you’ll receive a 429 response with the following fields:
  • limit: Maximum requests allowed in the violated time window
  • remaining: Requests remaining (always 0 in a 429 response)
  • retryAfterSeconds: Seconds to wait before retrying
For real-time updates without polling, consider using webhooks or our SDKs instead. Webhooks notify your server immediately when a run completes, eliminating the need for polling entirely.

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"

​
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.

​
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