Saltar al contenido principal
PUT

Actualizar rol de usuario

Scope:system:users.write
https://api.holded.com/api/v2/account/users/{userId}

Actualiza el rol de un miembro del equipo de la cuenta.

Parámetros

Parámetros de ruta

userIdstringobligatorio

Identificador del usuario (ObjectId hexadecimal de 24 caracteres)

Cuerpo de la petición

object
rolestringrequired

Rol a asignar al usuario (p. ej. admin, guest, finance)

Petición

python
import requests

url = "https://api.holded.com/api/v2/account/users/5f43a0d1a8a1e5001f56c456"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "role": "admin"
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Respuestas

Respuestas exitosas

204Rol actualizado

Respuestas de error

400Solicitud incorrecta (campo requerido ausente o rol inválido)application/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Cuenta o usuario no encontradoapplication/json
422No se puede cambiar el rol del propietario de la cuenta
429Límite de solicitudes excedidoapplication/json