Suggest Vault Scope

View as Markdown

Resolve the minimum safe vault scope from the user’s recent conversation, using only this API key holder’s authorized vault names, keywords, known people and cached summaries. Call it after list_vaults when the right vault is not explicit. Returns selected vault ids or a focused clarification question; it does not search vault content.

Authentication

AuthorizationBearer
Create a personal key in Alpha settings, or use an access token issued to an approved OAuth client.

Request

This endpoint expects an object.
conversationstringRequired

The recent user conversation that identifies a client, project, person or topic (maximum 12,000 trailing characters used).

Response headers

X-Request-IdstringOptional
Stable identifier for tracing this request in Alpha logs.

Response

Suggest Vault Scope completed.
datamap from strings to any or list of maps from strings to any
The result returned by the selected Alpha tool.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error