Skip to main content
GET
/
v1
/
actions
/
status
/
{auditId}
Query Async Action Status
curl --request GET \
  --url https://api.aegisintent.xyz/v1/actions/status/{auditId} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Aegis-Email: <x-aegis-email>'
{
  "success": true,
  "action": "CCTP_BRIDGE_USDC",
  "txHash": "<string>",
  "error": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.aegisintent.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Poll the status of a long-running asynchronous action such as a cross-chain bridge transfer. When you execute a bridge via POST /v1/actions/bridge, the server returns a 202 Accepted response with an auditId. Use this endpoint to poll for the final result.

​
Status Values

StatusMeaning
PENDINGAction has been created but not yet started
PROCESSINGAction is actively running in the background
SUCCESSAction completed successfully. txHash is set
FAILEDAction failed. error field contains details

Authorizations

​
Authorization
string
header
required

Provide raw API session token issued by /v1/connect/complete

Headers

​
X-Aegis-Email
string
required

Agent email address

Path Parameters

​
auditId
string<uuid>
required

The auditId returned from the async action (e.g. bridge)

Response

Action status retrieved

​
success
boolean
​
action
string
Example:

"CCTP_BRIDGE_USDC"

​
status
enum<string>

Current status of the background task

Available options:
PENDING,
PROCESSING,
SUCCESS,
FAILED
​
txHash
string | null

Transaction hash, available when status is SUCCESS

​
error
string | null

Error message, available when status is FAILED

​
createdAt
string<date-time>
​
updatedAt
string<date-time>