Skip to main content
POST
/
tools
/
{name}
/
deprecate
Soft-delete a tool
curl --request POST \
  --url https://api.mnemom.ai/v1/tools/{name}/deprecate \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>'
{
  "name": "<string>",
  "version": 2,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "display_name": "<string>",
  "description": "<string>",
  "schema": {},
  "source_connector": "<string>",
  "deprecated_at": "2023-11-07T05:31:56Z",
  "content_hash": "<string>"
}

Authorizations

​
Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Headers

​
Idempotency-Key
string
required
Required string length: 1 - 255

Path Parameters

​
name
string
required
Pattern: ^([a-z][a-z0-9_]{1,127}|org:[a-z0-9-]{3,64}:[a-z][a-z0-9_]{1,127})$

Response

Tool marked deprecated (or already deprecated).

​
name
string
required

Globally unique tool name. Convention: <connector>_<verb>_<noun> (e.g. campfire_create_chart_account). Org-scoped tools use the reserved org:<id>: prefix.

Pattern: ^([a-z][a-z0-9_]{1,127}|org:[a-z0-9-]{3,64}:[a-z][a-z0-9_]{1,127})$
​
class
enum<string>
required

8-entry action class taxonomy per mnemom-contracts/tool-manifest/v1.yaml. V7 gateway hooks bind on this for class-scoped enforcement.

Available options:
read,
internal_write,
consequential_internal_write,
consequential_external_write,
comms_internal,
comms_external,
engineering_attestation,
governance_write
​
domain
enum<string>
required

9-entry domain taxonomy. Used by domain-scoped value declarations like policy_attentiveness(domain: financial).

Available options:
financial,
engineering,
intelligence,
growth,
operations,
governance,
comms,
identity,
security
​
version
integer
required
Required range: x >= 1
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
display_name
string | null
​
description
string | null
​
schema
object

OpenAPI fragment / JSON Schema for the tool parameters. Populated when the tool is imported via OpenAPI spec.

​
source_connector
string | null
​
deprecated_at
string<date-time> | null
​
content_hash
string | null
Pattern: ^sha256:[a-f0-9]{64}$