Axuz Developers

PATCH /teams/{teamId}/mirror-groups/{gid}

Muda os campos sincronizados do grupo

  • Acesso: Membro da equipe
  • Serviço: https://api-workspace.axuz.net

Autenticação aceita

  • sessionCookie — Sessão plena Axuz (cookie de sessão da casa). Sessão restrita é 403 enrollment_required.
  • bearerSession — JWT de acesso da sessão em `Authorization: Bearer`.

Vale dali em diante (nao re-propaga o passado). Exige escrita em TODOS os membros (403 se algum nao for gravavel pelo ator). 404 se o ator nao enxerga nenhum membro do grupo. Emite task.mirror.group_updated.

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
gidpathstringsim

Corpo da requisição

application/json · Obrigatório

NomeTipoObrigatórioDescrição
sync_fieldsarray<string>sim
{
  "sync_fields": [
    "status"
  ]
}

Respostas

200

Grupo atualizado.

NomeTipoObrigatórioDescrição
groupMirrorGroupsim
group.idstring<uuid>sim
group.sync_fieldsarray<string>sim
group.max_membersintegersim
group.membersarray<oneOf>sim

400

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

401

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

403

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

404

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

429

Rate limit.

NomeTipoObrigatórioDescrição
errorstringsim
retry_afterintegernão

500

. Efeito: 1 SELECT + gates + 1 tx + 1 SELECT. Fluxo: configuração do espelho

NomeTipoObrigatórioDescrição
errorstringsim

Exemplos

O "Try it" está desligado nesta referência. Use os exemplos com a sua credencial de teste.

curl

curl -sS -X PATCH 'https://api-workspace.axuz.net/teams/TEAM_ID/mirror-groups/GID' \
  -H "Authorization: Bearer $AXUZ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sync_fields":["status"]}'

Node.js

const res = await fetch("https://api-workspace.axuz.net/teams/TEAM_ID/mirror-groups/GID", {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "sync_fields": [
      "status"
    ]
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

Python

import os
import requests

res = requests.request(
    "PATCH",
    "https://api-workspace.axuz.net/teams/TEAM_ID/mirror-groups/GID",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    json={
        "sync_fields": [
            "status",
        ],
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())