v1Recursos/Team/patchAtualizar um membro da equipe
Atualizar um membro da equipe
Atualiza a capacidade de horas semanais, as permissões de módulo ou o usuário do Slack vinculado de um membro da equipe. Pelo menos um campo deve ser fornecido. Isto não pode alterar o papel de um membro.
patch
team:write/api/v1/team/membersCorpo da solicitação
memberIdstringobrigatório
ID do membro da equipe.
weeklyHoursCapacitynumberopcional
Nova capacidade de horas semanais de trabalho, entre 0 e 80.
permissionsobjectopcional
Flags de acesso por módulo a conceder. Opcional; quando omitido (ou vazio), a predefinição de permissões padrão de membro é usada.
slackUserIdstringopcional
ID de usuário do Slack para vincular a este membro, ou null para desvincular. Vincular um ID do Slack já usado por outro membro o desvincula desse outro membro.
Resposta
dataobjectopcional
memberobjectopcional
Os campos realmente alterados por esta atualização — não o perfil completo do membro. Consulte GET /api/v1/team/members para ver o registro completo.
idstringopcional
Identificador único do membro da equipe.
weeklyHoursCapacitynumberopcional
A capacidade de horas semanais de trabalho do membro, ou null se não definida.
permissionsobjectopcional
Flags de acesso por módulo (dashboard, clients, listings, etc.), ou null se nunca definidas.
slackUserIdstringopcional
O ID de usuário do Slack vinculado a este membro, ou null se nenhum.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
patch/api/v1/team/members
Sua chave de API
Corpo da solicitação*
{
"data": {
"member": {
"id": "cm_user_2",
"weeklyHoursCapacity": 35,
"permissions": {
"posts": true,
"reviews": true,
"seo": true
},
"slackUserId": "U12345"
}
}
}Guias que usam 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.