tools

Preview an import of tool definitions from an OpenAPI spec or connector YAML manifest.

Parses the spec, extracts tool definitions, and optionally calls the LLM to infer class+domain. Never auto-commits — the caller iterates the imported[] array and writes each tool individually via POST /v1/tools. Platform-admin only. SSRF-defended (localhost / link-local / RFC-1918 blocked).

post/tools/import

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/tools/import
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Mnemom-Api-Key
    • API key in cookie mnemom_session

Request body

format'openapi' | 'connector_yaml' required
source'inline' | 'url' required
contentstring

Raw spec text. Required when source=inline.

urlstring

Public URL to fetch the spec. Required when source=url.

infer_class_domainboolean

When true (default), calls the LLM to infer class + domain per tool.

Response

Preview of the imported tool definitions.

oktrue required
importedobject[] required
inferred_class_domainobject required
conflictsobject[] required
commit_urlstring required
preview_tokenstring required

Changes

No recorded changes to this operation across all 1 revision of this API.