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.

Code	Country
`fr`	France (default)
`ch`	Switzerland
`it`	Italy
`be`	Belgium
`lu`	Luxembourg
`de`	Germany
`es`	Spain
`pt`	Portugal
`gb`	United Kingdom
`mc`	Monaco
`gr`	Greece
`ad`	Andorra
`nl`	Netherlands
`us`	United States
`mu`	Mauritius
`ma`	Morocco
`intl`	International

`language` — Response language

The language the agent responds in.

Code	Language
`fr`	French (default)
`en`	English
`de`	German
`es`	Spanish
`it`	Italian
`pt`	Portuguese

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.

Value	Behavior
`false`	Fast response (default)
`true`	The 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.

Value	Behavior
`null`	Auto — 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"
  }'

Getting Started

Endpoints

Guides

Parameters

Parameters

`residence` — Jurisdiction

`language` — Response language

`extended_thinking` — Deep reasoning

`effort` — Analysis depth

Example: complex cross-border query

​Parameters

​residence — Jurisdiction

​language — Response language

​extended_thinking — Deep reasoning

​effort — Analysis depth

​Example: complex cross-border query

Parameters

`residence` — Jurisdiction

`language` — Response language

`extended_thinking` — Deep reasoning

`effort` — Analysis depth

Example: complex cross-border query