List async operations

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

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.

Authentication required — include an Authorization: Bearer hsk_... header. See Authentication for details.

Path Parameters

Name	Type	Required	Description
bank_id	string	Yes

Query Parameters

Name	Type	Required	Description
status	string | null	No	Filter by status: pending, processing, completed, failed, or cancelled
type	string | null	No	Filter by operation type: retain, consolidation, refresh_mental_model, file_convert_retain, webhook_delivery
limit	integer	No	Maximum number of operations to return
offset	integer	No	Number of operations to skip
exclude_parents	boolean	No	Exclude parent batch operations from results

Example Request

curl -X GET 'https://api.hindsight.vectorize.io/v1/default/banks/your-bank-id/operations' \
  -H 'Authorization: Bearer hsk_your_api_key'

Responses

200 — Successful Response

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

422 — Validation Error

{
  "detail": [
    {
      "loc": [
        null
      ],
      "msg": "Message",
      "type": "Error Type",
      "input": null,
      "ctx": {},
      "url": "URL"
    }
  ]
}

---

Source: /v1/default/banks/{bank_id}/operations