Retry an action-run item

POST

/projects/:projectId/action-runs/:runId/items/:itemId/retry

Re-queues a failed item for another attempt, re-checking the action and template pins on re-execution.

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

projectIdstringRequired

runIdstringRequired

itemIdstringRequired

The re-queued item.

itemmap from strings to any

An action-run item projection (one per input).

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

1	curl -X POST https:/https://api/projects/projectId/action-runs/runId/items/itemId/retry \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"item": {
3	"id": "item_9f8b7c6d5e4a3b2c1d0e",
4	"status": "queued",
5	"attempt": 2,
6	"lastError": "Timeout while connecting to external API",
7	"createdAt": "2024-06-10T15:22:30Z",
8	"updatedAt": "2024-06-10T15:45:00Z",
9	"metadata": {
10	"retryReason": "network_failure",
11	"priority": "high"
12	}
13	}
14	}