Skip to main content
POST
/
api
/
agent
POST /api/agent
curl --request POST \
  --url https://api.inwealth.fr/api/agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "role": "<string>",
      "content": "<string>"
    }
  ],
  "session_id": "<string>",
  "residence": "<string>",
  "language": "<string>",
  "extended_thinking": true,
  "effort": "<string>"
}
'

​
Agent

Send a conversation to the iNwealth AI agent and receive a streaming response.

​
Request

​
messages
object[]
required
Conversation history.
​
session_id
string
required
Unique session identifier (client-side). Reuse the same ID for a conversation to benefit from Anthropic’s prompt caching.
​
residence
string
default:"fr"
Country code for the end-user’s tax residence. The agent adapts its answers to local legislation.Supported: fr, ch, it, be, lu, de, es, pt, gb, mc, gr, ad, nl, us, mu, ma, intl
​
language
string
default:"fr"
Response language. Supported: fr, en, de, es, it, pt
​
extended_thinking
boolean
default:false
Enable Claude’s native extended thinking mode. The agent reasons explicitly before answering — recommended for complex or cross-border questions.
​
effort
string
Analysis depth. Controls how deeply the agent analyzes the question.Values: low, medium, high, max, or null (auto — the agent decides based on complexity).

​
Example request

curl -X POST https://api.inwealth.fr/api/agent \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d '{
    "messages": [
      {"role": "user", "content": "Compare taxation of stock options in France vs Switzerland"}
    ],
    "session_id": "session-001",
    "residence": "fr",
    "language": "en",
    "extended_thinking": true,
    "effort": "high"
  }'

​
Response

The response is a streaming SSE (text/event-stream) with five event types:
EventDescription
deltaText fragment (content or thinking) — append to your display
metadataMetadata about the response (sources, markers)
doneEnd of stream with final message
errorError during streaming (rate limit, internal error)
clarificationClarifying questions before answering — collect user input (V170)
event: delta
data: {"type": "delta", "delta": {"content": "Stock options are taxed differently "}}

event: delta
data: {"type": "delta", "delta": {"content": "in France and Switzerland..."}}

event: metadata
data: {"type": "metadata", "data": {"markers": [...]}}

event: done
data: {"type": "done", "final_message": {"role": "assistant", "content": "..."}}
When extended_thinking is enabled, delta events can also contain thinking data: 
event: delta
data: {"type": "delta", "delta": {"thinking": "Analyzing cross-border implications...", "phase": "RECHERCHE", "step": "Exit tax treaty provisions"}}

​
Error responses

StatusMeaning
200OK — SSE stream
401Invalid or revoked API key
400Invalid parameters (e.g. bad effort value)
422Missing required fields
429Daily token quota exceeded