proxy

OpenAI Responses API, governed and recorded (non-streaming only)

Same base URL as chat-completions.

stream: true is rejected with a clear error. Non-streaming only.

OpenAI models only. Built-in tools such as web_search work and their cost is included in recorded spend.

post/v1/responses

Request

  • Base URL: https://www.spendline.ai
  • URL: https://www.spendline.ai/v1/responses
  • Auth: API key in header x-spendline-key

Headers

Authorizationstring required

The application's OWN OpenAI key, as Bearer <key>.

x-agent-idstring

Stable name of the bot/agent/feature making the call, e.g. support-bot. One per agent. Not per request. Required when attribution enforcement is enabled.

x-customer-idstring

The end customer this request is billable to. PER REQUEST. A hardcoded value makes per-customer cost attribution useless, thread it from request context. Required when attribution enforcement is enabled.

x-spendline-tagsstring

JSON object that must include a cost-centre key: one of cost_center, costCenter, department, or team. Example: {"team":"support","env":"prod"} Per call site or per request. Required when attribution enforcement is enabled.

x-workflow-idstring

Groups a multi-step run.

x-step-namestring

Labels a step within a workflow.

x-source-routestring

The application route that triggered the call.

Request body

modelstring required
inputunknown
toolsobject[]

Built-in tools such as web_search work; their cost is included in recorded spend.

streamboolean

Must be false or omitted. true is rejected.

Response

OpenAI Responses payload, passed through unchanged.

Changes

No recorded changes to this operation across all 1 revision of this API.