Poll the execution state of an async operation (withdrawal, trigger, etc.) dispatched on a portfolio.
POST /v2/portfolios/:id/withdraw or
POST /v2/portfolios/:id/trigger. Use to poll for onchain confirmation.
Operations transition through:
completed, failed, and cancelled are terminal — stop polling once
you see one.
x-api-key header (required)portfolios:read| Field | Type | Notes |
|---|---|---|
operationId | string | Echo of the URL param. |
portfolioId | string | Echo of the URL param. |
kind | string | withdraw, rebalance, bridge, swap. |
state | enum | Current lifecycle state. |
createdAt / updatedAt | ISO 8601 | Operation timestamps. |
finishedAt | ISO 8601 or null | Set once the operation reaches a terminal state. |
error | string or null | Set on failed/cancelled. Free-form message. |
401 when x-api-key header is missing or the key is invalid403 when the API key lacks the portfolios:read scope404 when the portfolio doesn’t exist, belongs to a different tenant,
or the operationId doesn’t correspond to any operation on that portfolio500 on unexpected server errors