Skip to main content
GET
/
public
/
v1
/
task-runs
/
{runId}
/
logs
Retrieve task run logs
curl --request GET \
  --url https://api.komos.ai/public/v1/task-runs/{runId}/logs \
  --header 'Authorization: Bearer <token>'
{
  "runId": "9c77d908-7bf4-4e7f-9a20-2c5e7fdf2e94",
  "logEntries": [
    {
      "id": "8c160f06-72c3-44d1-b0bb-0cb7284987b1",
      "timestamp": "2025-10-14T18:22:03.489Z",
      "level": "info",
      "message": "Navigated to https://example.com/orders/48219",
      "nodeId": "navigate_orders"
    },
    {
      "id": "ff5f2fd2-9b41-41df-9cf1-6e51497a1f26",
      "timestamp": "2025-10-14T18:22:07.902Z",
      "level": "warning",
      "message": "Retrying element click after timeout",
      "nodeId": "click_retry"
    }
  ]
}
Use this endpoint to stream structured log entries produced during automation. Entries are returned in ascending chronological order. New logs become available moments after they are persisted by the runner.

​
Request

​
Path parameters

  • runId — UUID of the run whose logs you want to inspect.

​
Example

curl -X GET \
  https://api.komos.ai/public/v1/task-runs/9c77d908-7bf4-4e7f-9a20-2c5e7fdf2e94/logs \
  -H 'Authorization: Bearer sk_live_example'

​
Responses

  • 200 OK — Returns { "runId": UUID, "logEntries": LogEntry[] }.
  • 400 Bad Request — Invalid run ID.
  • 401 Unauthorized — Missing or malformed API key.
  • 404 Not Found — The run is not visible to the authenticated organization.

​
Log entry schema

Each item in logEntries contains the following fields:
  • id (UUID) — Unique identifier for the log row.
  • timestamp (string | null) — ISO 8601 timestamp when the event was recorded.
  • level (“info” | “warning” | “error”) — Normalized severity.
  • message (string) — Human-readable summary of the event. Empty strings may appear when the underlying step emits no message.
  • nodeId (string | null) — Identifier of the builder node that produced the log, if available.
Combine this endpoint with task-run.log webhook deliveries to monitor runs in near real time.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
runId
string<uuid>
required

UUID of the run to inspect.

Response

Log entries returned.

​
runId
string<uuid>
required
​
logEntries
object[]
required