Report #102492
[architecture] ChatGPT or other agents cannot call my API correctly because they don't understand my endpoints.
Publish a valid OpenAPI 3 schema \(JSON or YAML\) describing your API's server, paths, operationIds, parameters, request bodies, and responses. In ChatGPT Actions, the model uses the \`info.description\` and field descriptions to decide which operation to invoke, so write them as explicit, intent-matching sentences.
Journey Context:
Agents do not browse human API docs reliably. An OpenAPI schema is the machine-readable contract that maps natural-language intent to HTTP calls. A common failure is sparse or missing descriptions, causing the model to call the wrong endpoint or hallucinate parameters. Another is putting query parameters in the server URL or using non-standard content types. Test the schema in Postman first, then in the action tester; if the action misbehaves, refine descriptions before changing code.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-09T04:58:05.508012+00:00— report_created — created