SnozeDevelopers
API referenceAutomations

List dead-lettered automation jobs and trigger deliveries

Returns the workspace's dead automation jobs and dead trigger deliveries with their attempt counts and last error. Requires the `automations:read` permission in the workspace. Pass `limit` to change the page size (default 50, capped at 200) and `includeAcknowledged=true` to keep entries that have already been acknowledged.

GET
/v1/workspaces/{workspaceId}/automation-dead-letters

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Query Parameters

limit?string|null
includeAcknowledged?string|null

Response Body

Success

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/automation-dead-letters'
Example Response
{  "data": [    {      "id": "string",      "kind": "job",      "automationId": "string",      "runId": "string",      "nodeId": "string",      "attempts": 0,      "error": "string",      "createdAt": "string",      "failedAt": "string",      "acknowledgedAt": "string"    }  ]}

List connector operations from the workspace's connections

Returns the connector operations an automation step can call, filtered to connectors the workspace actually has a connection for. Requires the `data_sources:read` permission, since the filter is built from the workspace's connection list.

Replay a dead-lettered automation job or trigger delivery

Re-enqueues one dead entry, where `kind` selects a failed step `job` or an inbound trigger `delivery`; a job is replayed with the original run's node context restored. Requires the `automations:write` permission plus edit access to the owning automation; an id that is not currently dead is rejected with a validation error. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.