Retrieve logs for a specific execution

curl --request GET \
  --url https://production.runalloy.com/logs/{id} \
  --header 'Authorization: <authorization>'

{
  "data": {
    "_id": "68110fea7d181f356acd1bf1",
    "executionMode": "cli",
    "executionUuid": "35SnGU0DUSNP5L26fsmnq",
    "workflowId": "67ef01ed8eaeb50b18e646ea",
    "userId": "67a21c7d10e1dee8d5ec3a3d",
    "forgeWorkflowId": "67ef017d8eaeb50b18e635a1",
    "finished": true,
    "retries": [],
    "actions": 3,
    "metadata": {},
    "runData": {},
    "connections": {},
    "startedAt": "2025-04-29T17:44:10.336Z",
    "stoppedAt": "2025-04-29T17:44:10.393Z"
  }
}

GET

logs

{id}

Retrieve logs for a specific execution

curl --request GET \
  --url https://production.runalloy.com/logs/{id} \
  --header 'Authorization: <authorization>'

{
  "data": {
    "_id": "68110fea7d181f356acd1bf1",
    "executionMode": "cli",
    "executionUuid": "35SnGU0DUSNP5L26fsmnq",
    "workflowId": "67ef01ed8eaeb50b18e646ea",
    "userId": "67a21c7d10e1dee8d5ec3a3d",
    "forgeWorkflowId": "67ef017d8eaeb50b18e635a1",
    "finished": true,
    "retries": [],
    "actions": 3,
    "metadata": {},
    "runData": {},
    "connections": {},
    "startedAt": "2025-04-29T17:44:10.336Z",
    "stoppedAt": "2025-04-29T17:44:10.393Z"
  }
}

Headers

Authorization

string

default:bearer YOUR_API_KEY

required

Path Parameters

string

required

The execution ID for which to retrieve logs.

Example:

"68110fea7d181f356acd1bf1"

Response

200 - application/json

Logs for the specified execution retrieved successfully

data

object

Show child attributes

data._id

string

Example:

"68110fea7d181f356acd1bf1"

data.executionMode

enum<string>

Available options:

cli,

error,

internal,

manual,

retry,

trigger,

webhook

Example:

"cli"

data.executionUuid

string

Example:

"35SnGU0DUSNP5L26fsmnq"

data.workflowId

string

Example:

"67ef01ed8eaeb50b18e646ea"

data.userId

string

Example:

"67a21c7d10e1dee8d5ec3a3d"

data.forgeWorkflowId

string

Example:

"67ef017d8eaeb50b18e635a1"

data.finished

boolean

Example:

true

data.retries

any[]

Example:

[]

data.actions

integer

Example:

3

data.metadata

object

Show child attributes

data.metadata.{key}

object

Show child attributes

data.metadata.{key}.name

string

Example:

"Step Name"

data.metadata.{key}.subtitle

string

Example:

"Step Subtitle"

data.metadata.{key}.icon

string

Example:

"https://cdn.runalloy.com/icons/alloy-logo.png"

data.metadata.{key}.type

string

Example:

"action"

data.metadata.{key}.inputs

object

Example:

{ "key": "value" }

data.runData

object

Show child attributes

data.runData.{key}

object

Show child attributes

data.runData.{key}.error

string | null

Example:

null

data.runData.{key}.data

object[][] | null

Show child attributes

data.runData.{key}.data.json

object

Example:

{ "output": "result" }

data.runData.{key}.data.statusCode

integer | null

Example:

200

data.runData.{key}.data.id

string

Example:

"block-uuid"

data.connections

object

Show child attributes

data.connections.{key}

object

Show child attributes

data.connections.{key}.main

object[][]

Show child attributes

data.connections.{key}.main.block

string

Example:

"block-uuid"

data.connections.{key}.main.type

string

Example:

"action"

data.connections.{key}.main.index

integer

Example:

0

data.startedAt

string<date-time>

Example:

"2025-04-29T17:44:10.336Z"

data.stoppedAt

string<date-time>

Example:

"2025-04-29T17:44:10.393Z"

Retrieve logs for all workflows

Retrieve usage metrics for a workflow

⌘I

Authentication

Credentials

Events

Headless Installation

Integrations

Installations

Passthrough

Logs & Usage

Metadata

Users

Workflows

App Actions Usage

Retrieve logs for a specific execution

Headers

Path Parameters

Response