# Actualizar usuario

Actualice la información de los usuarios en su comercio. Esta funcionalidad le permite modificar los roles, privilegios o cualquier otro dato pertinente de los usuarios existentes en Qentaz. Es esencial proporcionar la información actualizada precisa para asegurar que la gestión de usuarios en el sistema refleje los cambios deseados de manera efectiva y segura.

###  Ruta

<mark style="color:purple;">`PATCH`</mark> `/v1/merchant/team/{phone|email}`

## **Encabezado**

| Name                                                   | Value            |
| ------------------------------------------------------ | ---------------- |
| `Content-Type`*<mark style="color:red;">**\***</mark>* | application/json |
| `x-auth-token`*<mark style="color:red;">**\***</mark>* | {token}          |

## **Cuerpo**

<table><thead><tr><th width="228.60003662109375">Name</th><th width="148.53334554036456">Type<select><option value="onc1PB1cAF63" label="string" color="blue"></option><option value="4N53bB0d2HMA" label="numeric" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><code>nickname</code></td><td><span data-option="onc1PB1cAF63">string</span></td><td><p>Es el nombre con el que nos comunicaremos con el usuario, por ejemplo <em><strong>¡Hola Carlos!</strong></em></p><p><br><em><mark style="color:blue;"><code>Ejemplo: Carlos</code></mark></em></p></td></tr><tr><td><code>role</code></td><td><span data-option="onc1PB1cAF63">string</span></td><td>Define el rol que tendrá el usuario dentro de Trazo.<br><br><mark style="color:green;"><code>collector | member | analyst | specialist</code></mark></td></tr><tr><td><code>collect_limit</code></td><td><span data-option="4N53bB0d2HMA">numeric</span></td><td>Valor máximo autorizado para recaudar por el usuario en efectivo.<br><br><em><mark style="color:blue;"><code>Ejemplo: 2000000</code></mark></em></td></tr><tr><td><code>phone</code></td><td><span data-option="onc1PB1cAF63">string</span></td><td>Número de celular del usuario (incluir el código de área del país).  <br><br><em><mark style="color:blue;"><code>Ejemplo: 573112223333</code></mark></em></td></tr><tr><td><code>email</code></td><td><span data-option="onc1PB1cAF63">string</span></td><td>Correo del usuario.<br><br><em><mark style="color:blue;"><code>Ejemplo: cliente@minegocio.com</code></mark></em></td></tr><tr><td><code>external_user_id</code></td><td><span data-option="onc1PB1cAF63">string</span></td><td>Identificador asignado para el usuario.<br><br><em><mark style="color:blue;"><code>Ejemplo: KFF122</code></mark></em></td></tr></tbody></table>

## **Respuesta**

{% tabs %}
{% tab title="200" %}

```json
{
    "message": "The user has been updated.",
    "updated_at": "2024-08-27T13:33:52+00:00"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "error": "The user with 573112223333 is not registered in the system."
}
```

{% endtab %}

{% tab title="401" %}

```bash
{
    "status": "unauthorized",
    "code": "Q103",
    "error": "El x-auth-token se encuentra vencido. Por favor genera un nuevo token y reintenta de nuevo el cobro."
}
```

{% endtab %}
{% endtabs %}

***

## &#x20;Ejemplo

{% tabs %}
{% tab title="cURL" %}

```bash
curl --location --request PATCH '{{base_url}}/v1/merchant/team/573112223333' \
--header 'x-auth-token: {{token}}' \
--header 'Content-Type: application/json' \

--data '{
    "nickname": "DIEGO",
    "role": "member",
    "collect_limit": 10000000,
    "user_country": "Colombia",
    "user_state": "Cundinamarca",
    "user_city": "Bogotá",
    "external_user_id": "NTC73G"
}'
```

{% endtab %}

{% tab title="NodeJS (Axios)" %}

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "nickname": "DIEGO",
  "role": "member",
  "collect_limit": 10000000,
  "user_country": "Colombia",
  "user_state": "Cundinamarca",
  "user_city": "Bogotá",
  "external_user_id": "NTC73G"
});

let config = {
  method: 'patch',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/team/573112223333`,
  headers: { 
    'x-auth-token': token, //Añadir token 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

{% endtab %}

{% tab title="Python" %}

```python
import requests
import json

url = f"{base_url}/v1/merchant/team/573112223333"

payload = json.dumps({
  "nickname": "DIEGO",
  "role": "member",
  "collect_limit": 10000000,
  "user_country": "Colombia",
  "user_state": "Cundinamarca",
  "user_city": "Bogotá",
  "external_user_id": "NTC73G"
})
headers = {
  'x-auth-token': token, #Añadir token
  'Content-Type': 'application/json'153'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qentaz.com/documentation/equipo/actualizar-usuario.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.