Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.inwealth.fr/llms.txt

Use this file to discover all available pages before exploring further.

Parameters

The /api/agent endpoint accepts several optional parameters to customize the agent’s behavior.

residence — Jurisdiction

Country code of the end-user’s fiscal residence. The agent adapts its answers to local legislation.
CodeCountry
frFrance (default)
chSwitzerland
itItaly
beBelgium
luLuxembourg
deGermany
esSpain
ptPortugal
gbUnited Kingdom
mcMonaco
grGreece
adAndorra
nlNetherlands
usUnited States
muMauritius
maMorocco
intlInternational

language — Response language

The language the agent responds in.
CodeLanguage
frFrench (default)
enEnglish
deGerman
esSpanish
itItalian
ptPortuguese
residence and language are independent. A user residing in Switzerland (residence: "ch") can receive answers in English (language: "en").

extended_thinking — Deep reasoning

Activates Claude’s native extended thinking mode.
ValueBehavior
falseFast response (default)
trueThe agent reasons step-by-step before answering — better for complex, cross-border questions
Extended thinking uses more tokens but produces significantly better answers for complex cross-border scenarios.

effort — Analysis depth

Controls how deeply the agent analyzes the question.
ValueBehavior
nullAuto — the agent decides based on question complexity (default)
"low"Concise answer, minimal analysis
"medium"Detailed answer, moderate analysis
"high"In-depth analysis, broad source coverage
"max"Exhaustive analysis, all relevant sources

Example: complex cross-border query

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": "I am moving from France to Switzerland. How are my stock options taxed during the transition?"}
    ],
    "session_id": "session-crossborder",
    "residence": "fr",
    "language": "en",
    "extended_thinking": true,
    "effort": "max"
  }'