topai_openapi_flattener
Flatten OpenAPI 3.0/3.1 specs into self-contained JSON by resolving internal/external $refs and circular references; use before importing into RapidAPI, Postman, or LLM tools that reject $refs.
Instructions
Dereferences internal and external $ref pointers, neutralizes circular schema references, and flattens OpenAPI 3.0/3.1 specifications into a self-contained JSON document. Use before importing complex OpenAPI specs into RapidAPI, Postman, or LLM function-calling compilers that reject nested $ref pointers. Do not use for general JSON token minification (use topai_token_slimmer instead). Stateless, read-only, idempotent schema transformation.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "topai_openapi_flattener"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spec_url | No | Optional public HTTP/HTTPS URL pointing to an OpenAPI JSON specification to fetch and flatten. | |
| spec_json | No | Optional raw OpenAPI JSON string passed inline for immediate local dereferencing. |