Knowledge Base

Map Knowledge Base Collection

Attach a Collection

Requires the OWNER or ADMIN role. Attaches this collection to a folder or agent, so retrieval actually uses it -- a collection with no mapping is created but inert. Idempotent: mapping the same (collection, owner) pair again returns the existing row rather than erroring. ownerType cannot be automation here -- an automation's collection is set on its own AI step, not through this endpoint; see Get Collection Owners for how that link is surfaced instead.

post/knowledge-bases/{kbId}/map

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/knowledge-bases/{kbId}/map
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Path parameters

kbIdstring required

The collection's knowledgeBaseId.

Request body

ownerType'folder' | 'agent' required
ownerIdstring required

Response

OK

status'success'

Changes

No recorded changes to this operation across all 2 revisions of this API.