Operations

List async operations

Changed on

Get a list of async operations for a specific agent, with optional filtering by status and operation type. Results are sorted by most recent first.

get/v1/default/banks/{bank_id}/operations

Request

Path parameters

bank_idstring required

Query parameters

statusstring nullable

Filter by status: pending, processing, completed, failed, or cancelled

typestring nullable

Filter by operation type: retain, consolidation, refresh_mental_model, file_convert_retain, webhook_delivery

limitinteger

Maximum number of operations to return

offsetinteger

Number of operations to skip

exclude_parentsboolean

Exclude parent batch operations from results

Headers

authorizationstring nullable

Response

Successful Response

bank_idstring required
totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "bank_id": "user123",
  "limit": 20,
  "offset": 0,
  "operations": [
    {
      "created_at": "2024-01-15T10:30:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "items_count": 5,
      "status": "pending",
      "task_type": "retain"
    }
  ],
  "total": 150
}

Changes

    • warning

      added the new candidate_rejected enum value to the ///// response property for the response status

    • warning

      added the new refresh_failed_candidate_rejected enum value to the //// response property for the response status

    • warning

      removed the optional property // from the response with the status

    • info

      added the non-success 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