Get Endpoint Details (All $ref Resolved)
swagger_get_endpoint_fullRetrieve a complete API endpoint definition with all schema references expanded inline. Avoid manual $ref resolution and get fully resolved parameters, request, and response schemas in one call.
Instructions
Get detailed information about a specific API endpoint with all schema references ($ref) recursively resolved.
Unlike swagger_get_endpoint, this tool resolves every $ref into its full schema definition. Parameters, request body schemas, and response schemas are expanded inline with no external references. Circular references are detected and marked.
Use this when you need the complete endpoint definition in a single call, without needing to follow $ref links manually.
Args:
spec_name (string): Name of the previously loaded spec
path (string): URL path of the endpoint (e.g., "/pets/{petId}")
method (string): HTTP method (get, post, put, patch, delete, options, head)
Returns: Full endpoint details with all $ref resolved recursively.
Examples:
Use when: "Show me everything about GET /pets/{petId} with all schemas expanded" -> params with spec_name="", path="/pets/{petId}", method="get"
Use when: "Give me the full request body schema for creating a user" -> params with spec_name="", path="/users", method="post"
Error Handling:
Returns error if the spec name has not been loaded
Returns error if the path or method is not found, with suggestions
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | URL path of the endpoint (e.g., '/pets/{petId}', '/users', '/store/order'). Must start with '/'. | |
| method | Yes | HTTP method (get, post, put, patch, delete, options, head) | |
| spec_name | Yes | Name of the previously loaded OpenAPI/Swagger spec (use swagger_list_loaded to see available names) |