---
title: "Update Knowledge"
method: PATCH
path: "/accounts/{account_id}/experience"
tags: ["Accounts: General"]
---

# Update Knowledge

`PATCH /accounts/{account_id}/experience`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/experience`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/experience/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- ExperienceTransitionKnowledgeInput
  - `non_complex_products` ExperienceDetailKnowledgeInput
    - `knowledge` 'none' | 'knowledgeable', required: A category specifying the knowledge level for a specific type of instrument: <ul> <li><code>none</code>: The user is not knowledgeable with regards to this type of instrument. <li><code>knowledgeable</code>: The user is knowledgeable with regards to this type of instrument. </ul>
  - `structured_investment_products` ExperienceDetailKnowledgeInput
    - `knowledge` 'none' | 'knowledgeable', required: A category specifying the knowledge level for a specific type of instrument: <ul> <li><code>none</code>: The user is not knowledgeable with regards to this type of instrument. <li><code>knowledgeable</code>: The user is knowledgeable with regards to this type of instrument. </ul>
  - `swap_based_ucits_and_alternative_investment_funds` ExperienceDetailKnowledgeInput
    - `knowledge` 'none' | 'knowledgeable', required: A category specifying the knowledge level for a specific type of instrument: <ul> <li><code>none</code>: The user is not knowledgeable with regards to this type of instrument. <li><code>knowledgeable</code>: The user is knowledgeable with regards to this type of instrument. </ul>

## Response `200`

Successful Response

- ExperienceTransitionOutput
  - `non_complex_products` ExperienceDetailOutput
    - `experience` 'none' | 'from_1_to_5' | 'greater_than_5': A category describing the number of trades for a specific type of instrument in the last two years: <ul> <li><code>none</code>: No trades in the last 2 years for this type of instrument. <li><code>from_1_to_5</code>: 1 – 5 trades in the last 2 years for this type of instrument. <li><code>greater_than_5</code>: 6 or more trades in the last 2 years for this type of instrument. </ul> <strong>Note:</strong> This information is only required for the account onboarding. It cannot be updated at a later point in time. However, we will monitor the number of trades for any user and will automatically upgrade the experience profile.
    - `knowledge` 'none' | 'knowledgeable', required: A category specifying the knowledge level for a specific type of instrument: <ul> <li><code>none</code>: The user is not knowledgeable with regards to this type of instrument. <li><code>knowledgeable</code>: The user is knowledgeable with regards to this type of instrument. </ul>
  - `structured_investment_products` ExperienceDetailOutput
    - `experience` 'none' | 'from_1_to_5' | 'greater_than_5': A category describing the number of trades for a specific type of instrument in the last two years: <ul> <li><code>none</code>: No trades in the last 2 years for this type of instrument. <li><code>from_1_to_5</code>: 1 – 5 trades in the last 2 years for this type of instrument. <li><code>greater_than_5</code>: 6 or more trades in the last 2 years for this type of instrument. </ul> <strong>Note:</strong> This information is only required for the account onboarding. It cannot be updated at a later point in time. However, we will monitor the number of trades for any user and will automatically upgrade the experience profile.
    - `knowledge` 'none' | 'knowledgeable', required: A category specifying the knowledge level for a specific type of instrument: <ul> <li><code>none</code>: The user is not knowledgeable with regards to this type of instrument. <li><code>knowledgeable</code>: The user is knowledgeable with regards to this type of instrument. </ul>
  - `swap_based_ucits_and_alternative_investment_funds` ExperienceDetailOutput
    - `experience` 'none' | 'from_1_to_5' | 'greater_than_5': A category describing the number of trades for a specific type of instrument in the last two years: <ul> <li><code>none</code>: No trades in the last 2 years for this type of instrument. <li><code>from_1_to_5</code>: 1 – 5 trades in the last 2 years for this type of instrument. <li><code>greater_than_5</code>: 6 or more trades in the last 2 years for this type of instrument. </ul> <strong>Note:</strong> This information is only required for the account onboarding. It cannot be updated at a later point in time. However, we will monitor the number of trades for any user and will automatically upgrade the experience profile.
    - `knowledge` 'none' | 'knowledgeable', required: A category specifying the knowledge level for a specific type of instrument: <ul> <li><code>none</code>: The user is not knowledgeable with regards to this type of instrument. <li><code>knowledgeable</code>: The user is knowledgeable with regards to this type of instrument. </ul>

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)