v13

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-015232292.9 KB
Audit Logs

List Audit Logs

Retrieve audit logs for your organization with cursor-based pagination. Requires an Enterprise subscription and organization admin or owner role.

get/api/v1/audit-logs

Query parameters

actionstring

Filter by action type (e.g., workflow.created, workflow.deployed, member.invited).

resourceTypestring

Filter by resource type (e.g., workflow, workspace, member).

resourceIdstring

Filter by a specific resource ID.

workspaceIdstring required

The unique identifier of the workspace.

actorIdstring

Filter by the user who performed the action. Must be a member of your organization.

startDatestring date-time

Only return logs after this ISO 8601 timestamp (inclusive).

endDatestring date-time

Only return logs before this ISO 8601 timestamp (inclusive).

includeDepartedboolean

When true, includes audit logs from users who have left the organization.

limitinteger

Maximum number of audit log entries to return per page. Must be between 1 and 100.

cursorstring

Pagination cursor returned from a previous request's nextCursor field.

Response

A paginated list of audit log entries.

nextCursorstring nullable

Cursor for fetching the next page. null when there are no more results.

Example response

{
  "data": [
    {
      "id": "audit_2c3d4e5f6g",
      "workspaceId": "a91c4b2e-6d3f-4e8a-b5c7-0d9e2f1a8c64",
      "actorId": "user_abc123",
      "actorName": "Jane Smith",
      "actorEmail": "jane@example.com",
      "action": "workflow.deployed",
      "resourceType": "workflow",
      "resourceId": "3b1f7c92-8d4e-4a6b-9c0d-5e2f8a714b36",
      "resourceName": "Customer Support Agent",
      "description": "Deployed workflow Customer Support Agent",
      "createdAt": "2025-06-20T14:15:22Z"
    }
  ],
  "limits": {
    "workflowExecutionRateLimit": {
      "sync": {
        "requestsPerMinute": 60,
        "maxBurst": 10,
        "remaining": 59,
        "resetAt": "2025-06-20T14:16:00Z"
      },
      "async": {
        "requestsPerMinute": 60,
        "maxBurst": 10,
        "remaining": 59,
        "resetAt": "2025-06-20T14:16:00Z"
      }
    },
    "usage": {
      "currentPeriodCost": 1.25,
      "limit": 50,
      "plan": "pro"
    }
  }
}