Agent Platform

Agent Action API

Execute governed tools, track durable status and hand approval decisions back to Fullness.

POST/external/v1/actions/{toolName}/execute

Execute a tool released to the environment and authorized for the grant.

GET/external/v1/actions/{actionId}

Read status for an action owned by the same grant and workspace.

Request body

JSON

{
  "arguments": {
    "period": "last_30_days"
  },
  "idempotencyKey": "order-import-2026-09-01-0001"
}

idempotencyKey is required for every non-read operation and must contain 16–200 characters. Do not reuse a key for different arguments.

Action states

queuedwaiting_approvalwaiting_retryrunningsucceededfailedcancelled

Treat waiting_approval as durable progress, not an error. Present approvalUrl to the user, retain action.id, and poll the status endpoint with bounded backoff.

Approval boundary

Do not include an approval property; the API rejects it.
Do not embed, proxy or imitate the Fullness approval experience.
Do not collect the user’s Fullness password or approval credentials.
Do preserve the returned activity and approval URLs.

Retry policy

Reads may be retried with bounded exponential backoff after transient failures. The official SDKs never retry writes automatically. For a non-read operation, reuse the original idempotency key only when retrying the same intended operation.