Saltar al contenido principal
PUT
Set a member Away
Pone Ausente a un miembro, por ejemplo a alguien que se fue sin apagar su interruptor. Las etapas que asignan solo a miembros Activos dejan de darle leads nuevos hasta que la persona vuelva a activarse.

Antes de empezar

  • Las llaves MCP necesitan workflows:write. Las llaves REST de acceso completo no necesitan nada más.
  • Una llave que pertenece a una persona (por ejemplo, una llave MCP) solo funciona para owners y admins. Si no, devuelve 403 OWNER_OR_ADMIN_REQUIRED.
  • Si la disponibilidad del equipo no está activada en la cuenta, devuelve 403 TEAM_AVAILABILITY_UNAVAILABLE.

Solicitud

Qué pasa

  • El miembro queda Ausente, con changed_by: admin.
  • Los leads que ya tiene mantienen su responsable.
  • Un miembro que ya estaba Ausente queda igual: changed_at y changed_by mantienen los valores anteriores.
  • Si ningún miembro de la cuenta tiene ese ID, devuelve 404 MEMBER_NOT_FOUND.
  • No hay forma de dejar Activo a otra persona. Activarse es siempre decisión de cada miembro.

Relacionado

  • Con el MCP de Nexor, usa set_member_away.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

user_id
string<uuid>
requerido

The member's user ID, as returned in members[].user_id by GET /team/availability or by GET /team.

Cuerpo

application/json
availability
enum<string>
requerido

Only away is accepted.

Opciones disponibles:
away

Respuesta

The member is Away.

user_id
string<uuid>
requerido
availability
enum<string>
requerido
Opciones disponibles:
away
changed_at
string<date-time> | null
requerido

When the member went Away. If they were already Away, the earlier time is kept.

changed_by
enum<string> | null
requerido

admin when this call set them Away. If they were already Away, the earlier value is kept.

Opciones disponibles:
self,
idle,
admin
Última modificación el 21 de octubre de 2026