REST API — Vaults

Method	Path	What it does
GET	/api/chat-templates/{template_id}/vaults	List all vaults attached to a chat template.
GET	/api/threads/{thread_id}/vaults	List all vaults attached to a chat thread.
GET	/api/vaults	List vaults accessible to the user within the selected workspace (owned + shared).
POST	/api/vaults	Create a new vault in the selected workspace. Creator becomes owner.
POST	/api/vaults/search	Semantic search across multiple vaults.
DELETE	/api/vaults/{vault_id}	Delete vault. Requires owner role.
GET	/api/vaults/{vault_id}	Get vault details. Requires at least viewer access.
PATCH	/api/vaults/{vault_id}	Update vault. Requires admin or owner role.
POST	/api/vaults/{vault_id}/attach/template/{template_id}	Attach vault to chat template.
POST	/api/vaults/{vault_id}/attach/thread/{thread_id}	Attach vault to chat thread.
POST	/api/vaults/{vault_id}/attach/workflow/{workflow_id}	Attach vault to workflow.
GET	/api/vaults/{vault_id}/can-attach/template/{template_id}	Check if vault can be attached to a chat template.
GET	/api/vaults/{vault_id}/can-attach/thread/{thread_id}	Check if vault can be attached to a thread.
GET	/api/vaults/{vault_id}/can-attach/workflow/{workflow_id}	Check if vault can be attached to a workflow.
DELETE	/api/vaults/{vault_id}/detach/template/{template_id}	Detach vault from chat template. Requires admin access.
DELETE	/api/vaults/{vault_id}/detach/thread/{thread_id}	Detach vault from chat thread. Requires admin access.
DELETE	/api/vaults/{vault_id}/detach/workflow/{workflow_id}	Detach vault from workflow. Requires admin access.
GET	/api/vaults/{vault_id}/documents	List all documents in a vault. Requires viewer access.
POST	/api/vaults/{vault_id}/documents/upload	Upload a document to a vault.
DELETE	/api/vaults/{vault_id}/documents/{document_id}	Delete a document. Requires admin access.
GET	/api/vaults/{vault_id}/documents/{document_id}	Get document details. Requires viewer access.
POST	/api/vaults/{vault_id}/invite	Invite user to vault. Requires admin or owner role.
GET	/api/vaults/{vault_id}/members	List vault members. Requires viewer access.
DELETE	/api/vaults/{vault_id}/members/{user_id}	Remove member from vault. Requires owner role.
PATCH	/api/vaults/{vault_id}/members/{user_id}	Update member role. Requires owner role.
POST	/api/vaults/{vault_id}/search	Semantic search within a vault.
GET	/api/workflows/{workflow_id}/vaults	List all vaults attached to a workflow.