> ## 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.

# Async Action Status

> Poll the status of a long-running asynchronous action (e.g. cross-chain bridge). Returns the current status, transaction hash (when complete), and any error details.

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

| Status       | Meaning                                        |
| ------------ | ---------------------------------------------- |
| `PENDING`    | Action has been created but not yet started    |
| `PROCESSING` | Action is actively running in the background   |
| `SUCCESS`    | Action completed successfully. `txHash` is set |
| `FAILED`     | Action failed. `error` field contains details  |


## OpenAPI

````yaml GET /v1/actions/status/{auditId}
openapi: 3.1.0
info:
  title: Aegis Secure API
  description: >-
    Zero-trust API for Developer-Controlled Wallets (DCW) and programmatic
    Policy Engine controls.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.aegisintent.xyz
    description: Production API Server
security: []
paths:
  /v1/actions/status/{auditId}:
    get:
      tags:
        - Actions API
      summary: Query Async Action Status
      description: >-
        Poll the status of a long-running asynchronous action (e.g. cross-chain
        bridge). Returns the current status, transaction hash (when complete),
        and any error details.
      parameters:
        - name: auditId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The auditId returned from the async action (e.g. bridge)
        - name: X-Aegis-Email
          in: header
          required: true
          schema:
            type: string
          description: Agent email address
      responses:
        '200':
          description: Action status retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  action:
                    type: string
                    example: CCTP_BRIDGE_USDC
                  status:
                    type: string
                    enum:
                      - PENDING
                      - PROCESSING
                      - SUCCESS
                      - FAILED
                    description: Current status of the background task
                  txHash:
                    type: string
                    nullable: true
                    description: Transaction hash, available when status is SUCCESS
                  error:
                    type: string
                    nullable: true
                    description: Error message, available when status is FAILED
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
        '404':
          description: Task not found
      security:
        - BearerAuth: []
        - AegisEmail: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Provide raw API session token issued by `/v1/connect/complete`
    AegisEmail:
      type: apiKey
      in: header
      name: X-Aegis-Email
      description: Dual-header token holder identity confirmation

````