Skip to main content
GET
Get hosted tool allow-list

Authorizations

Authorization
string
header
required

Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.

Path Parameters

agent_id
string<uuid>
required

Response

HostedTools · object | null

Successful Response

An agent's hosted tool allow-list: GET/PUT /agents/{agent_id}/hosted-tools, AgentRead.hosted_tools and the config snapshot's hosted_tools.

mode is what the runtime does with a hosted tool outside the list: enforce refuses the request, monitor records it and lets it through. mcp_servers may be set without mcp in families: it is kept and served, and the runtime allows no MCP tool while mcp is not in the families (so an admin can switch MCP off without losing the server list).

mode
enum<string>
required
Available options:
monitor,
enforce
families
enum<string>[]
Available options:
web_search,
web_fetch,
code_execution,
computer,
shell,
file_search,
image_generation,
mcp,
advisor,
other
mcp_servers
HostedMcpServer · object[]
Maximum array length: 50