v1Recursos/Team/patchActualizar un miembro del equipo
Actualizar un miembro del equipo
Actualiza la capacidad de horas semanales, los permisos por módulo o el usuario de Slack vinculado de un miembro del equipo. Se debe indicar al menos un campo. Esto no puede cambiar el rol de un miembro.
patch
team:write/api/v1/team/membersCuerpo de la solicitud
memberIdstringobligatorio
ID del miembro del equipo.
weeklyHoursCapacitynumberopcional
Nueva capacidad de horas de trabajo semanales, entre 0 y 80.
permissionsobjectopcional
Indicadores de acceso por módulo a otorgar. Opcional; cuando se omite (o está vacío), se usa la plantilla de permisos predeterminada de miembro.
slackUserIdstringopcional
ID de usuario de Slack a vincular con este miembro, o null para desvincular. Vincular un ID de Slack ya usado por otro miembro lo desvincula de ese miembro.
Respuesta
dataobjectopcional
memberobjectopcional
Los campos realmente modificados por esta actualización — no el perfil completo del miembro. Consulta GET /api/v1/team/members para ver el registro completo.
idstringopcional
Identificador único del miembro del equipo.
weeklyHoursCapacitynumberopcional
La capacidad de horas de trabajo semanales del miembro, o null si no está establecida.
permissionsobjectopcional
Indicadores de acceso por módulo (dashboard, clients, listings, etc.), o null si nunca se establecieron.
slackUserIdstringopcional
El ID de usuario de Slack vinculado a este miembro, o null si no hay ninguno.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
patch/api/v1/team/members
Su clave de API
Cuerpo de la solicitud*
{
"data": {
"member": {
"id": "cm_user_2",
"weeklyHoursCapacity": 35,
"permissions": {
"posts": true,
"reviews": true,
"seo": true
},
"slackUserId": "U12345"
}
}
}Guías que usan este recurso
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.