Ingest Chat Completion

POST

https://host.com/apis/intake/v2/workspaces/:workspace/ingest/chat-completions

Path parameters

workspacestringRequired

Request

This endpoint expects an object.

requestobjectRequired

Flexible captured chat-completions request.

responseanyRequired

Flexible captured chat-completions response.

experiment_contextobjectOptional

Experiment context accepted by ingest endpoints.

evaluation_contextobjectOptional

Deprecated. Use experiment_context; when both are sent, experiment_context takes precedence.

session_idstringOptional

Groups related chat-completions calls without forcing them into the same trace.

trace_idstringOptional

Opt into joining an existing trace built via OTel or ATIF. This is not a grouping mechanism for chat-completions calls; use session_id to group related calls.

providerstringOptional

cost_usddoubleOptional>=0

Total estimated cost of this model call in USD. This matches ATIF step metrics; Intake stores it as semantic cost_total_usd on spans.

cost_input_usddoubleOptional>=0

Estimated input-token cost of this model call in USD.

cost_output_usddoubleOptional>=0

Estimated output-token cost of this model call in USD.

cost_detailsmap from strings to doublesOptional

Additional estimated cost breakdown fields in USD.

Response

Successful Response

session_idstring

span_idstring

Errors

422

Unprocessable Entity Error

$	curl -X POST https://host.com/apis/intake/v2/workspaces/workspace/ingest/chat-completions \
>	-H "Content-Type: application/json" \
>	-d '{
>	"request": {
>	"messages": [
>	{
>	"role": "user"
>	}
>	],
>	"model": "gpt-4o-mini"
>	},
>	"response": {
>	"error": {}
>	}
>	}'