Get Worker Run Log

Method: GET

Endpoint: /api/v2/worker-runs/{runId}/log

Authentication: Supports Authorization: Bearer <YOUR_API_KEY>, api-key: <YOUR_API_KEY>, and ?token=<YOUR_API_KEY>. Prefer Bearer token.

Try it

GET/api/v2/worker-runs/{runId}/logGet worker run log

AuthenticationRequired

Auth mode

Authorization: Bearerapi-key headerQuery token

API token

Stored only in this browser tab. Sent only to https://openapi.coreclaw.com.

Parameters

runIdpath · stringRequired

Run slug returned as `data.run_slug` from start or rerun responses.

Request BodyNot applicable

No JSON request body. Fill the path or query parameters above.

Send Request Clear all

When to use this endpoint

Use this endpoint to read run logs for monitoring and troubleshooting.

Identifier Notes

• runId is the run slug. Use data.run_slug from start or rerun responses as the runId.

Path Parameters

Parameter	Required	Type	Description
runId	Yes	string	Run slug returned as data.run_slug from start or rerun responses.

Request Example

curl -X GET "https://openapi.coreclaw.com/api/v2/worker-runs/YOUR_RUN_ID/log" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "code": 0,
  "data": {
    "all_logs_url": "https://storage.example.com/runs/01KKDXV2G26BT7NH4ZQR2R4NPZ/logs.txt",
    "list": [
      "Run started",
      "Run finished"
    ],
    "result_count": 1
  },
  "message": "success",
  "request_id": "req-123"
}

Response Fields

Field	Type	Description
data.all_logs_url	string	Download URL for the full log. This URL may be temporary — download promptly; contact support for retention policy.
data.list[]	array	Log entries; fields are platform-defined.
data.list[].type	integer	Platform-defined log type marker.
data.list[].group	string	Subtask or group identifier.
data.list[].content	string	Log text content.
data.list[].timestamp	integer	Log timestamp in milliseconds.
data.result_count	integer	Current result count.

Notes

• API v2 supports Bearer token, the legacy api-key header, and query token. Prefer Bearer token for new integrations.
• See Run Lifecycle & Status for status handling, polling, failure diagnosis, and cancellation behavior.

HTTP Responses

HTTP Status	Application Code	Meaning
200	0	OK
400	11000	Bad Request
401	12001	Unauthorized
404	11004	Not Found
422	11000	Unprocessable Entity
429	13000	Too Many Requests
500	10000	Internal Server Error