Dynamiq
Knowledge Bases

Bulk delete knowledge base items

Deletes several knowledge base items (and their indexed documents) in one request. The ids array must contain unique item UUIDs.

POST
/v1/knowledgebases/{knowledgebase_id}/items/bulk/delete

Authorization

personalAccessToken
AuthorizationBearer <token>

Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.

In: header

Path Parameters

knowledgebase_id*string

Knowledge base UUID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/knowledgebases/497f6eca-6276-4993-bfeb-53cbbbba6f08/items/bulk/delete" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "8d9e0f1a-2b3c-4d4e-8f5a-6b7c8d9e0f1a",      "4e5f6071-8293-44b5-86d7-e8f90112a3b4"    ]  }'
{
  "message": "deleted"
}
{
  "error": {
    "code": "bad_request",
    "message": "Bad Request",
    "details": {
      "input": "cannot be blank"
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

List knowledge base items

Lists items (ingested documents) of a knowledge base, most recently uploaded first by default.

Reprocess knowledge base items

Re-runs ingestion for a knowledge base's items. Restrict the operation to items in specific processing states with the optional `statuses` array; when omitted, all items are reprocessed. Items are reprocessed asynchronously.