Bulk Delete Documents

Bulk delete knowledge documents (max 100 per request).

Address documents either by their AGO UUID (‘document_ids’) or, for callers that imported them under their own key, by ‘source_id’ + ‘page_ids’. In page_id mode ‘not_found’ comes back as page_ids, so it matches the caller’s own records.

POST /api/v1/documents/bulk-delete

Bulk Delete Documents

cURL

curl --request POST \
  --url https://{tenant_id}.api.useago.com/api/v1/documents/bulk-delete \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "document_ids": [],
  "source_id": "<string>",
  "page_ids": []
}
'

200

{
  "deleted": 123,
  "not_found": [
    "<string>"
  ],
  "errors": [
    {}
  ],
  "object": "bulk_result"
}

Authorizations

X-API-Key · string · header · required

Body

application/json

Schema for bulk deleting documents. Max 100 IDs per request.

Documents are addressed either by their AGO UUID ('document_ids') or, for callers that imported them under their own key, by 'source_id' + 'page_ids'. Exactly one of the two addressing modes per request.

document_ids · string[]

source_id · string | null

page_ids · string[]

Response

200 - application/json

OK

Response schema for bulk document deletion.

deleted · integer · required

not_found · string[] · required

errors · Errors · object[] · required

object · string · default: bulk_result