Skip to main content

aiToolsGetAllowAlways

List aiToolsGetAllowAlways(entityId)

GET /api/2.0/ai/tools/get-allow-always

Get allow always

Returns the always-allow list of the scope - the tools whose calls run without pausing the round for approval. entityId picks the scope and omitting it reads the portal-wide setting. An empty answer means every tool call has to be approved through POST api/2.0/ai/ai/approve-tool-call. Use GET api/2.0/ai/tools/is-allow-always to ask about a single tool.

Parameters​

NameInTypeDescriptionNotes
entityIdqueryStringThe DocSpace entity the request is scoped to - the room, folder or agent workspace the chat is invoked from. Omit for the portal-wide scope.[optional] [example: 1234]

Responses​

Status codeDescriptionTypeResponse headers
200The tools that run without an approval pause. An empty list means every call needs approval.List-
401Missing asc_auth_key cookie or Authorization header.AiErrorResponse-
403AI is disabled for this portal, the caller is a guest, or the room named by entityId is one the caller cannot open. Relayed from the DocSpace AI service or the Files API.AiErrorResponse-
500Unhandled failure. The reason is logged server-side and never echoed back.AiErrorResponse-

Return type​

List

Authorization​

cookieAuth, bearerAuth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json