Create a response
OpenAI Responses API. Supports non-streaming and streaming (the response.created → response.output_text.delta → response.completed event taxonomy), stateful storage (store, previous_response_id chaining), and background: true async runs (returns status: "queued" immediately; poll or reconnect via GET /v1/responses/{id}). Managed tools are not yet supported — a non-empty tools list is rejected.
Authorization
bearerAuth A Maniac API key, sent as Authorization: Bearer <key>. (Internal service-to-service calls use a separate internal service key and are not documented here.)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/responses" \ -H "Content-Type: application/json" \ -d '{ "model": "string", "input": "string", "property1": null, "property2": null }'{ "id": "string", "object": "response", "created_at": 0, "status": "queued", "error": null, "incomplete_details": null, "instructions": null, "max_output_tokens": null, "model": "string", "output": [], "parallel_tool_calls": true, "previous_response_id": null, "reasoning": null, "temperature": null, "top_p": null, "text": { "format": { "type": "string" } }, "tool_choice": null, "tools": [], "truncation": null, "usage": null, "metadata": {}, "provider": "string"}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}{ "error": { "message": "string", "type": "string", "param": "string", "code": "string" }}