---
search:
  tags:
    - Shops
    - PUT
seo:
  description: >-
    Renames a vendedor user or disables/enables their access to the seller.…
    Reference for the PUT /shops/{shop_id}/admins/{id} endpoint in the Bolder
    API v2.
sidebar:
  label: Update or disable a dealer user
  badge: PUT
title: Update or disable a dealer user
type: openapi-operation
---
Renames a `vendedor` user or disables/enables their access to the seller. Needs `shops.write`. A disabled
dealer keeps the user but gets no scopes: logins, token exchanges and refreshes fail, and the merchant admin
refuses them. Access tokens already issued last until they expire (1 hour). Users with another role answer `422`.

`PUT /shops/{shop_id}/admins/{id}`

**Request body** (`application/json`, required)

- `name` (string)
- `disabled` (boolean)
- `branch_id` (integer) — Moves the dealer to this sucursal (replacing their current one); blank takes them out of it; omitted leaves it as is.

Request body example:

```json
{
  "name": "string",
  "disabled": true,
  "branch_id": 0
}
```

**Responses**

- `200` — The dealer user
- `403` — Access denied
- `404` — User not found in this shop
- `422` — Not a dealer user, or invalid or unknown fields

Response example, 200:

```json
{
  "id": 11,
  "email": "ana@dealer.cl",
  "name": "Ana Dealer",
  "role": "vendedor",
  "disabled": true,
  "last_logged_on": "2024-06-20T14:00:00Z"
}
```