Create a response
POST/v1/responses
OpenAI Responses, on any model in the catalog. Send model and input; set stream: true for the typed response.* event stream. Turns are stored for 30 days unless store: false and chain by previous_response_id. conversation, prompt and context_management are refused with a 400. The response's model echoes the alias you sent.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 404
- 429
- 503
The response object; status is completed, incomplete, or failed.
Response Headers
Present when a previous_response_id chain was cut short (expired, deleted, or past the 25-turn walk).
Parameters adjusted to the model's range, as name=requested>applied. Absent when nothing was clamped.
Comma-separated parameters the target model could not take and that were dropped. Absent when nothing was dropped.
Malformed body, or a parameter the target model cannot honor and that is refused rather than dropped (param_not_supported, invalid_param, max_tokens_exceeded, model_not_configured). Also unsupported_parameter for conversation, prompt, or context_management.
Missing or invalid Authorization: Bearer mdb_… (invalid_credentials).
The wallet is empty and this model is not covered by included tokens (wallet_empty).
Response Headers
Machine-readable denial reason (rate_limited, included_allowance_exhausted, wallet_empty).
Relative console URL where credit can be added.
The key is valid but not permitted here (permission_denied).
Unknown model alias (model_not_found) or unknown, expired, or deleted previous_response_id (previous_response_not_found).
Too fast (rate_limited, retry after Retry-After) or included tokens exhausted with no payment method (included_allowance_exhausted, wait for X-MindsHub-Reset-At).
Response Headers
Seconds to wait before retrying.
Machine-readable denial reason (rate_limited, included_allowance_exhausted, wallet_empty).
ISO-8601 instant the allowance resets.
The authorization gate is unavailable (policy_unavailable). Retry.