Index documents
POST/content-assistance/index
Crawls and indexes one or more documents into the specified knowledge base index type. The documents are fetched from their URLs, chunked, and stored for use in retrieval-augmented generation.
- For GENERAL type: only
urlsis required. - For CATEGORY / CATEGORY_SHARED type: provide
urlsplus eitherscopeIds(category concept IDs) orbreadcrumbs. - For PRODUCT type: provide
urlsplus eitherscopeIds(product IDs) oridentifiers. - For CONDITIONAL / CONDITIONAL_SHARED type: provide
urlsplusscopeIds(the IDs of the Conditional Documents the URLs should be attached to, as listed under AI Knowledge Base in Data Platform).
The _SHARED variants index documents across all locales (the project group); the non-shared CATEGORY and CONDITIONAL variants apply to the current locale only. GENERAL and PRODUCT are always locale-specific.
This operation is asynchronous and returns a task that can be monitored via the Tasks endpoint.
Request
Responses
- 200
- 400
- 401
- 404
OK — indexing task started
Bad request — invalid type, missing URLs, or missing scopeIds for CATEGORY, CATEGORY_SHARED, PRODUCT, CONDITIONAL, or CONDITIONAL_SHARED type
Unauthorized — invalid or missing API key
Project not found