Workspaces

Build the knowledge graph

Builds the workspace's knowledge graph over its ingested files, as a kg_build job. Pricing to be announced.

post/v1/workspaces/{id}/knowledge-graph/builds

Request

Path parameters

idstring required

The workspace's workspace_id.

Query parameters

wait_secondsinteger

Hold the request open until the job finishes, up to this many seconds. 0 (default) returns at once; a value above 60 waits 60.

Headers

Idempotency-Keystring

Up to 200 characters, unique per account. Retry identical inputs with the same key to get the original job; use a new key for changed inputs.

Request body

forceboolean

Clear the graph and rebuild it from scratch.

Response

The job, finished within wait_seconds.

job_idstring uuid required
kindstring required

The document service's job kind, such as ingestion, reconciliation, kg_build, intelligent_search (automatic search), automatic_agent (QA), file_replace, file_delete or workspace_delete.

status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
workspace_idstring
resultunknown

Changes

No recorded changes to this operation across all 1 revision of this API.