Skip to main content
POST
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
Creates an empty repository. A repository indexes its documents so you can search them. Add files to it with Add Documents. The caller becomes the repository’s admin, as if they had created it in the app. Share it in the app to give others access.

Authentication

Requires an API key, or an OAuth token with repositories:write. The caller’s role must allow creating repositories.

Body parameters

string
required
The repository name, up to 200 characters. Names do not have to be unique.
string
What the repository holds, up to 2,000 characters. Shown in the app and returned by the API.

Response

Returns 201 with the new repository. document_count is 0 and indexing_status is idle.
string
idle once every document is indexed, indexing while any document is still waiting, failed when any document could not be indexed.
The other fields are the ones List Repositories returns.

Errors