Update or disable a dealer user

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}

Authorization

AuthorizationBearer token (JWT) · headerrequired

Path parameters

shop_idintegerrequired

idintegerrequired

Request body

requiredapplication/json

namestring

disabledboolean

branch_idinteger

Moves the dealer to this sucursal (replacing their current one); blank takes them out of it; omitted leaves it as is.

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

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

shop_idpath*idpath*

Bodyapplication/json

namestringdisabledbooleanbranch_idintegerMoves the dealer to this sucursal (replacing their current one); blank takes them out of it; omitted leaves it as is.

Request

curl -X PUT 'https://api.onbolder.com/v2/shops/1/admins/10' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "disabled": true,
  "branch_id": 0
}'

const response = await fetch("https://api.onbolder.com/v2/shops/1/admins/10", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"disabled\": true,\n  \"branch_id\": 0\n}"
});

import requests

response = requests.put(
    "https://api.onbolder.com/v2/shops/1/admins/10",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"disabled\": true,\n  \"branch_id\": 0\n}",
)

Response

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