Skip to main content
POST
Register a new tool

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Headers

Idempotency-Key
string
required

Per-mutation idempotency key (RFC draft-ietf-httpapi-idempotency-key-header).

Required string length: 1 - 255

Body

application/json
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
description
string | null
display_name
string | null
schema
object | null

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

source_connector
string | null

Response

Tool registered.

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 | null

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}$