Cancel a queued execution - mailerpath-docs

POST

client

executions

{execution_id}

cancel

Cancel a queued execution

curl --request POST \
  --url http://localhost:8080/api/v1/client/executions/{execution_id}/cancel \
  --header 'Authorization: <api-key>'

{
  "data": {
    "contact_id": 123,
    "execution_id": 123,
    "is_test": true,
    "processed_at": "<string>",
    "queue_id": 123,
    "reason": "<string>",
    "status_text": "<string>",
    "workflow_id": 123
  },
  "errors": [
    {
      "condition": "format",
      "error": "Invalid email format",
      "key": "email"
    }
  ],
  "message": "Operation successful",
  "meta": {},
  "success": true
}

Authorizations

Authorization

string

header

required

JWT Bearer token or raw API key via Authorization header

Path Parameters

execution_id

integer

required

Execution ID

Response

data

object

Show child attributes

errors

object[]

Show child attributes

message

string

Example:

"Operation successful"

meta

object

success

boolean

Example:

true

Retry a failed executionRetry a failed execution for the authenticated client by enqueueing a new workflow queue item. This response acknowledges queueing only; use GET /client/executions/{execution_id} as the source of truth for final outcome state and reason.

⌘I

Cancel a queued execution

curl --request POST \
  --url http://localhost:8080/api/v1/client/executions/{execution_id}/cancel \
  --header 'Authorization: <api-key>'

{
  "data": {
    "contact_id": 123,
    "execution_id": 123,
    "is_test": true,
    "processed_at": "<string>",
    "queue_id": 123,
    "reason": "<string>",
    "status_text": "<string>",
    "workflow_id": 123
  },
  "errors": [
    {
      "condition": "format",
      "error": "Invalid email format",
      "key": "email"
    }
  ],
  "message": "Operation successful",
  "meta": {},
  "success": true
}