AVavaprotocol
Executions

Deliver an approval/external signal to a waiting execution

Changed on

Resumes a WAITING execution (durable execution). The caller must own the workflow; the signal only counts against an actual pending wait whose kind it matches and which has not timed out. v1 is the external-signal (human approval) flavor — e.g. a Telegram approve/reject for a money-moving step.

post/executions/{id}:signal

Request

  • Base URL
    https://api.avaprotocol.org/api/v1
  • Auth
    HTTP bearer

Request body

decision'approve' | 'reject' required

The approver's decision.

payloadobject

Optional structured data delivered as the await step's output.

Response

The resumed (terminal or still-waiting) execution.

idstring required

ULID identifier (26-char Crockford base32).

workflowIdstring required

ULID identifier (26-char Crockford base32).

chainIdinteger

Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filter params it is optional.

indexinteger

0-based run counter within the workflow.

startAtinteger required
endAtinteger
status'pending' | 'waiting' | 'success' | 'failed' | 'error' required

Outcome of an execution. pending is in-flight; waiting is suspended mid-workflow at an await node, durably parked until a signal arrives (a human approve/reject or an operator-observed chain event) or the wait times out — non-terminal, like pending, but distinguishable so a client can show "awaiting approval"; success is full success; failed is logical failure (e.g., a node returned an error, or a wait timed out); error is a system / infrastructure failure (e.g., RPC unreachable).

errorstring

Example response

{
  "id": "01JG2FE5MDVKBPHEG0PEYSDKAC",
  "workflowId": "01JG2FE5MDVKBPHEG0PEYSDKAC",
  "chainId": 11155111,
  "steps": [
    {
      "errorDetails": {
        "token": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
      }
    }
  ],
  "authorization": {
    "missingActions": [
      {
        "target": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
      }
    ],
    "missingTokens": [
      "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
    ],
    "required": {
      "allowedActions": [
        {
          "target": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
        }
      ],
      "erc20SpendCaps": [
        {
          "token": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
          "amount": "500000000"
        }
      ],
      "nativeRecipients": [
        "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
      ],
      "nativeSpendCap": {
        "amount": "10000000000000000"
      }
    }
  }
}

Changes

  • 6b505ebcf3f7Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 4ebf07931311Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status