Agents

Quote Agent Session Voice

What a voice session WOULD cost. Charges nothing.

A POST only because the ceilings are a body. It returns a credit figure and a rate_version, and that version is the point: hand it straight to POST /agent/sessions/{session_id}/voice, which refuses a stale one rather than starting at today's price against yesterday's quote.

Tiered as a READ for that reason. It is the only way to learn the price before committing to it, so a read-only key must be able to call it.

post/agent/sessions/{session_id}/voice/quote

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/sessions/{session_id}/voice/quote
  • Auth: HTTP bearer

Path parameters

session_idstring required

Session id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

voice_idstring uuid required

Which voice to price.

max_input_secondsinteger

Ceiling on spoken input to price for.

max_output_charactersinteger

Ceiling on synthesised output to price for.

Response

Successful Response

dataAgentSessionStatePayload required

An open envelope for a hydration or voice answer.

Open because session hydration returns the agent's STEPS as well as its messages, and a step's detail is whatever the tool that produced it reported. That set grows with every tool the platform gains, and a pinned mirror would drop the detail of exactly the newest ones - which on a transcript surface reads as the agent having done less than it did.

Changes

No recorded changes to this operation across all 2 revisions of this API.