action_classes.deregister

Live

Soft-delete a custom action class; historical ledger rows preserved.

CategoryAction
JSON-RPCtools/call
EndpointPOST /mcp
Sourcepackages/mcp-tools/src/tools/action-classes-deregister.ts

Description

Sets deregistered_at. Re-registration requires the same client_id. Per ADR-0022.

Input schema

FieldTypeRequiredDescription
class_idstringyesUUID of the class to deregister.

Output shape

typescript
{ ok: true } | { ok: false; error: 'not_found' | 'wrong_client'; message: string }

Example call

JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):

jsontools/call params
{ "name": "action_classes.deregister", "arguments": { "class_id": "550e8400-e29b-41d4-a716-446655440000" } }

Example response

Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):

jsonparsed result body
{ "ok": true }

Errors this tool can return

CodeMeaning
not_foundThe requested resource (action_id, decision_id, counterparty_id, etc.) was not found.
invalid_argumentsTool input failed Zod validation.
unauthorizedMissing or invalid bearer token.

See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).