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"
ISO 2-letter country code for the end-user’s tax residence. The agent adapts its answers to local legislation.Supported: fr, ch, lu, be, mc, de, it, es, pt, gb, us, ae, sg, hk, il, br, ma
​
language
string
default:"fr"
Response language. Supported: fr, en, de, it, es, 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 explores the Knowledge Graph.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 three event types:
EventDescription
deltaText fragment of the response (progressive streaming)
metadataMetadata: KG sources, visited nodes, markers
doneEnd of stream
event: delta
data: {"text": "Stock options are taxed differently "}

event: delta
data: {"text": "in France and Switzerland..."}

event: metadata
data: {"visited_nodes": ["fr_stock_options", "ch_stock_options"], "markers": [...]}

event: done
data: {}

​
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