Skip to main content
GET
/
runs
/
workflow
/
{workflow_id}
/
errors
Get workflow error analytics
curl --request GET \
  --url https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors \
  --header 'cc-key: <api-key>'
{
  "workflow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "timeframe": {
    "start": "2025-10-01T00:00:00Z",
    "end": "2025-10-29T23:59:59Z"
  },
  "total_errors": 15,
  "error_groups": {
    "ELEMENT_NOT_FOUND": {
      "count": 8,
      "errors": [
        {
          "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "created_at": "2025-10-29T10:00:00Z",
          "error_code": "ELEMENT_NOT_FOUND",
          "error_category": "RECOVERABLE_ERROR",
          "message": "Element not found on page",
          "error_details": "The selector did not match any elements on the page"
        }
      ]
    },
    "NETWORK_TIMEOUT": {
      "count": 7,
      "errors": [
        {
          "session_id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
          "created_at": "2025-10-29T11:00:00Z",
          "error_code": "NETWORK_TIMEOUT",
          "error_category": "RECOVERABLE_ERROR",
          "message": "Request timed out",
          "error_details": "The network request exceeded the timeout limit"
        }
      ]
    }
  }
}

Authorizations

​
cc-key
string
header
required

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

Path Parameters

​
workflow_id
string<uuid>
required

Unique identifier for the workflow

Query Parameters

​
start_timestamp
string<date-time>
required

Start of the time range (ISO 8601 format)

Example:

"2025-10-01T00:00:00Z"

​
end_timestamp
string<date-time>
required

End of the time range (ISO 8601 format)

Example:

"2025-10-29T23:59:59Z"

​
limit
integer
default:1000

Maximum number of errors to retrieve

Required range: 1 <= x <= 1000

Response

Workflow error analytics successfully retrieved

Aggregated error analytics for a workflow within a specific time range

​
workflow_id
string<uuid>
required

Unique identifier for the workflow

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
timeframe
object
required

Time range for the error analytics

​
total_errors
integer
required

Total number of errors in the time range

Example:

15

​
error_groups
object
required

Errors grouped by error code

Example:
{
  "ELEMENT_NOT_FOUND": {
    "count": 8,
    "errors": [
      {
        "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "created_at": "2025-10-29T10:00:00Z",
        "error_code": "ELEMENT_NOT_FOUND",
        "error_category": "RECOVERABLE_ERROR",
        "message": "Element not found on page",
        "error_details": "The selector did not match any elements on the page"
      }
    ]
  },
  "NETWORK_TIMEOUT": {
    "count": 7,
    "errors": [
      {
        "session_id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
        "created_at": "2025-10-29T11:00:00Z",
        "error_code": "NETWORK_TIMEOUT",
        "error_category": "RECOVERABLE_ERROR",
        "message": "Request timed out",
        "error_details": "The network request exceeded the timeout limit"
      }
    ]
  }
}