POST/replay-jobs

Create a replay job

Requires Bearer authentication. See Authentication.

Request body

Field Type Description

name string —

customerAccountId string (uuid) —

scopeDefinitionrequired ScopeDefinition —

typerequired enum (5) —

filtersrequired ScopeFilters —

`destinationIds`	string (uuid)[]	—
`eventTypes`	string[]	—
`startTime`	string (date-time)	—
`endTime`	string (date-time)	—
`deliveryStatuses`	enum (6)[]	—
`environment`	"PRODUCTION" \| "STAGING" \| "DEVELOPMENT"	—

rateLimit integer —

Responses

201 201

Field Type Description

idrequired string (uuid) —

tenantIdrequired string (uuid) —

customerAccountIdrequired string (uuid) —

requestedByrequired string (uuid) —

namerequired string —

scopeTyperequired enum (5) —

scopeDefinitionrequired ScopeDefinition —

typerequired enum (5) —

filtersrequired ScopeFilters —

`destinationIds`	string (uuid)[]	—
`eventTypes`	string[]	—
`startTime`	string (date-time)	—
`endTime`	string (date-time)	—
`deliveryStatuses`	enum (6)[]	—
`environment`	"PRODUCTION" \| "STAGING" \| "DEVELOPMENT"	—

statusrequired enum (6) —

totalCountrequired number —

succeededCountrequired number —

failedCountrequired number —

remainingCountrequired number —

rateLimitrequired number —

startedAtrequired string (date-time) —

completedAtrequired string (date-time) —

cancelledAtrequired string (date-time) —

createdAtrequired string (date-time) —

400 400

Field Type Description

errorrequired object —

`code`required	string	—
`message`required	string	—
`details`	any	—

Errors

Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.

curl -X POST https://api.pushrail.io/replay-jobs \ -H "Authorization: Bearer pk_live_..." \ -H "Content-Type: application/json" \ -d ' { "name": "string", "customerAccountId": "00000000-0000-0000-0000-000000000000", "scopeDefinition": { "type": "FAILED_DELIVERIES", "filters": { "destinationIds": [ "00000000-0000-0000-0000-000000000000" ], "eventTypes": [ "string" ], "startTime": "2026-10-27T16:42:41.864Z", "endTime": "2026-10-27T16:42:41.864Z", "deliveryStatuses": [ "PENDING" ], "environment": "PRODUCTION" } }, "rateLimit": 50 }'

{ "id": "00000000-0000-0000-0000-000000000000", "tenantId": "00000000-0000-0000-0000-000000000000", "customerAccountId": "00000000-0000-0000-0000-000000000000", "requestedBy": "00000000-0000-0000-0000-000000000000", "name": "string", "scopeType": "FAILED_DELIVERIES", "scopeDefinition": { "type": "FAILED_DELIVERIES", "filters": { "destinationIds": [ "00000000-0000-0000-0000-000000000000" ], "eventTypes": [ "string" ], "startTime": "2026-10-27T16:42:41.869Z", "endTime": "2026-10-27T16:42:41.869Z", "deliveryStatuses": [ "PENDING" ], "environment": "PRODUCTION" } }, "status": "PENDING", "totalCount": 0, "succeededCount": 0, "failedCount": 0, "remainingCount": 0, "rateLimit": 0, "startedAt": "2026-10-27T16:42:41.869Z", "completedAt": "2026-10-27T16:42:41.869Z", "cancelledAt": "2026-10-27T16:42:41.869Z", "createdAt": "2026-10-27T16:42:41.869Z" }