Skip to main content

API keys

Generated from apiome-rest/openapi.yaml (API version 1.204.1) — do not edit by hand. How to authenticate is on the REST API reference.

Tag: api-keys · 2 operations

GET /api-keys/mcp-capability-presets​

List MCP capability presets

Enumerate named capability profiles (Catalog only, Search + catalog, Full read) with the documented toolset enable matrix for tenant MCP policy drafts (MTG-5.1, #4785). Custom is not listed — it is a UI sentinel for non-matching drafts.

Operation id: list_mcp_capability_presets_api_keys_mcp_capability_presets_get

Parameters

NameInTypeRequiredDescription
authorizationheaderstring or nullnoJWT bearer token for authenticated access (Authorization: Bearer <token>).
X-API-Keyheaderstring or nullnoTenant-scoped API key used as an alternative to JWT bearer authentication.

Responses

StatusDescriptionBody
200Successful response for list mcp capability presets.application/json McpCapabilityPresetsResponse
422Validation Errorapplication/json HTTPValidationError

GET /api-keys/mcp-tools​

List MCP tools and toolsets

Enumerate every registered Apiome MCP tool id (and planned capability ids such as spec.mcp / spec.catalog), with description and toolset membership for admin enable/disable UX (MTG-1.1, #4765). Same source of truth as apiome-mcp call-time fail-closed checks.

Operation id: list_mcp_tools_api_keys_mcp_tools_get

Parameters

NameInTypeRequiredDescription
authorizationheaderstring or nullnoJWT bearer token for authenticated access (Authorization: Bearer <token>).
X-API-Keyheaderstring or nullnoTenant-scoped API key used as an alternative to JWT bearer authentication.

Responses

StatusDescriptionBody
200Successful response for list mcp tools and toolsets.application/json McpToolCatalogResponse
422Validation Errorapplication/json HTTPValidationError

Schemas used​

HTTPValidationError​

Validation error response emitted when request data fails schema checks.

PropertyTypeRequiredDescription
detailarray of ValidationErrornoDetail.

McpCapabilityPresetsResponse​

Named MCP capability presets (MTG-5.1). Custom is a UI sentinel only.

PropertyTypeRequiredDescription
presetsarray of McpCapabilityPresetItemyesNamed packs in display order; see docs/MCP_CAPABILITY_PRESETS.md.

McpToolCatalogResponse​

Full MCP tool & capability catalog (MTG-1.1).

PropertyTypeRequiredDescription
toolsarray of McpToolCatalogItemyesEvery registered tool / capability id, in registry order.