Set Tool Status
SetToolStatus transitions a catalog tool through its lifecycle states
(active / deprecated / blocked). Workspace operators use this to hide
dangerous tools from agents (blocked → filtered from tools/list and
denied at tools/call) or to mark superseded tools (deprecated → still
callable, surfaced with a warning chip; gateway-side propagation as
_meta.dome.deprecated lands in #685).
Blocked transitions trigger regeneration of the workspace-scoped
managed Cedar bundle (generator=blocked_tools, file=blocked-tools.cedar).
The bundle is one `forbid` policy per blocked tool; Cedar's forbid-wins
semantics override the per-connection tool-<connection>.cedar permits.
Permission: gateway.manage. Allowed callers: identity.PlatformUser.
POST
cURL
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
SetToolStatusRequest targets one catalog tool by (workspace_id, tool_id). The handler verifies the tool belongs to the workspace before writing.
Response
200 - application/json
OK
cURL