Skip to main content
GET
/
logs
Retrieve logs for all workflows
curl --request GET \
  --url https://production.runalloy.com/logs \
  --header 'Authorization: <authorization>'
{
  "notifications": [
    {
      "_id": "68110feaa81a0e507fbdd36a",
      "message": "executionError",
      "data": {
        "executionId": "68110fea7d181f356acd1bf1",
        "executionUuid": "35SnGU0DUSNP5L26fsmnq"
      },
      "startedAt": "2025-04-29T17:44:10.336Z",
      "completedAt": "2025-04-29T17:44:10.432Z",
      "createdAt": "2025-04-29T17:44:10.432Z",
      "customVersion": false,
      "workflowVersion": 1,
      "teamId": "63fcaa053522280b5357aeec",
      "forgeWorkflowId": "67ef017d8eaeb50b18e635a1",
      "workflowId": "67ef01ed8eaeb50b18e646ea",
      "userId": "67a21c7d10e1dee8d5ec3a3d",
      "user": {
        "email": "[email protected]",
        "fullName": "Eduardo Souza"
      },
      "forgeWorkflow": {
        "name": "order_id example",
        "integrationId": {
          "_id": "67d8875977ce6522e517a382",
          "name": "Eduardo looper",
          "blockId": "MuK2Kk9lu0v8N86brS3x",
          "icon": "https://cdn.runalloy.com/icons/alloy-logo.png"
        }
      }
    }
  ],
  "lastFetched": "2025-04-29T17:46:38.237Z",
  "pagination": {
    "totalItems": 4,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}

Headers

​
Authorization
string
default:bearer YOUR_API_KEY
required

Query Parameters

​
filters
string

Array of filter objects to narrow down logs based on specific criteria. Pass as a JSON-encoded array string in the query parameter.

Example: [ { "columns": { "value": "message" | "data.executionId" | "forgeWorkflowId" | "createdAt" | "userId" | "forgeWorkflow.integrationId._id" | "workflowVersion" }, "operators": { "value": "notequals" | "equals" | "greaterthan" | "lessthan" | "equals" | "contains" | "notcontains" | "notequals" }, "userinput": { "value": String }, "condition": { "value": "and" } } ]

Example:

"[{\"columns\":{\"value\":\"message\"},\"operators\":{\"value\":\"equals\"},\"userinput\":{\"value\":\"executionError\"},\"condition\":{\"value\":\"and\"}}]"

​
workflowId
string

To filter by a given workflow instead of all workflows of all users.

Example:

"67ef017d8eaeb50b18e635a1"

​
associatedUserId
string

To filter user-specific logs instead of all users.

Example:

"67a21c7d10e1dee8d5ec3a3d"

​
skip
integer

Amount of docs to skip.

Example:

0

​
limit
integer

Amount of docs to return (page size).

Example:

10

​
sortBy
enum<string>

Sort by (createdAt, completedAt, message, userId).

Available options:
createdAt,
completedAt,
message,
userId
Example:

"createdAt"

​
sortOrder
enum<string>

Sort order (asc or desc).

Available options:
asc,
desc
Example:

"desc"

Response

200 - application/json

Logs retrieved successfully

​
notifications
object[]
​
lastFetched
string<date-time>
Example:

"2025-04-29T17:46:38.237Z"

​
pagination
object