PIpioneer
Finetune Agent
agent-chat-sessions

Report Mle Agent Turn Billing

Changed on

Crash-safe per-turn billing endpoint for MLE chat sessions.

Args: request: FastAPI request used by the rate-limiter. session_id: agent_chat_sessions.id for the active chat. body: Per-turn usage payload with dedup key. auth: Authenticated caller; must own session_id.

Returns: AgentTurnBillingResponse with request_id and billed flag.

Raises: HTTPException: 404/403 for ownership failures.

post/v1/finetune-agent/sessions/{session_id}/billing/agent-turn

Request

Path parameters

session_idstring uuid required

Request body

turn_idstring required

Sandbox-supplied dedup key for this turn (UUID recommended).

providerstring required
modelstring required
input_tokensinteger
output_tokensinteger

Response

Successful Response

request_idstring nullable

Normally null for accepted compatibility self-reports; may contain a cached legacy requests row id for old dedup entries.

billedboolean required

False for accepted compatibility self-reports; brokered sandbox LLM usage is billed server-side on /v1/messages.

Changes