> ## 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

> Configure the agent's behavior with request parameters

# 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       |

<Note>
  `residence` and `language` are independent. A user residing in Switzerland (`residence: "ch"`) can receive answers in English (`language: "en"`).
</Note>

## `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 |

<Info>
  Extended thinking uses more tokens but produces significantly better answers for complex cross-border scenarios.
</Info>

## `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

```bash theme={null}
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"
  }'
```