Skip to navigation
Referencia APIBookings

Actualizar a una persona del equipo

Cambia su nombre, presentación, color, comisión, lugar en la lista, si recibe reservas (bookable) o los servicios que atiende (service_ids, la lista completa). Lo que no envíes no cambia.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

idstringRequired

Request

This endpoint expects an object.
namestringOptional<=60 characters
biostringOptional<=280 characters
colorstringOptional

Color en la agenda, hexadecimal. Sin él, uno de la paleta.

bookablebooleanOptional
Si recibe reservas.
commission_percentdoubleOptional0-100
positionintegerOptional
service_idslist of stringsOptional

Los servicios que atiende (IDs svc_ o de producto). Reemplaza la lista.

Response

La persona actualizada
idstringOptional
account_idstringOptional
namestringOptional
biostring or nullOptional
colorstringOptional
bookablebooleanOptional
Si recibe reservas ahora.
commission_percentdouble or nullOptional

Su comisión sobre lo que atiende, para el reporte del equipo.

positionintegerOptional

Su lugar en la lista del equipo y en la página pública.

service_idslist of stringsOptional
created_atdatetimeOptional

Errors

422
Unprocessable Entity Error