Axuz Developers

POST /teams/{teamId}/tasks/{id}/mirrors

Cria a tarefa-espelho em outro board

  • 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`.

Cria uma tarefa NOVA em board_id (copia inicial de titulo, descricao, prazo, prioridade e status da origem) e a junta ao grupo da origem; o grupo e criado se ainda nao existir. column_id opcional (default: primeira coluna do board). sync_fields so vale ao CRIAR o grupo; com o grupo ja existente, envie-o por PATCH /mirror-groups/{id} (422 se vier junto).

422 quando: board_id nao esta acessivel NESTE team (outro team ou inexistente ou fora do alcance: mesma resposta, sem oraculo); column_id nao e do board; board sem colunas; grupo cheio (10); o board ja tem membro neste grupo.

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
idpathstringsim

No servico o segmento e {id}; o nome aqui e so descritivo.

Corpo da requisição

application/json · Obrigatório

NomeTipoObrigatórioDescrição
board_idstring<uuid>sim
column_idstring<uuid> | nullnão
sync_fieldsarray<string>não
{
  "board_id": "00000000-0000-0000-0000-000000000000",
  "column_id": "00000000-0000-0000-0000-000000000000",
  "sync_fields": [
    "status"
  ]
}

Respostas

201

Espelho criado.

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

A tarefa-espelho criada (mesmo shape de GET /tasks/{id}).

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

409

(grupo mudou na corrida)

NomeTipoObrigatórioDescrição
errorstringsim

422

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

429

Rate limit.

NomeTipoObrigatórioDescrição
errorstringsim
retry_afterintegernão

500

. Efeito: gate + 1 tx + 2 SELECT. Fluxo: "espelhar em outro board" na UI

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 POST 'https://api-workspace.axuz.net/teams/TEAM_ID/tasks/ID/mirrors' \
  -H "Authorization: Bearer $AXUZ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"board_id":"00000000-0000-0000-0000-000000000000","column_id":"00000000-0000-0000-0000-000000000000","sync_fields":["status"]}'

Node.js

const res = await fetch("https://api-workspace.axuz.net/teams/TEAM_ID/tasks/ID/mirrors", {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "board_id": "00000000-0000-0000-0000-000000000000",
    "column_id": "00000000-0000-0000-0000-000000000000",
    "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(
    "POST",
    "https://api-workspace.axuz.net/teams/TEAM_ID/tasks/ID/mirrors",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    json={
        "board_id": "00000000-0000-0000-0000-000000000000",
        "column_id": "00000000-0000-0000-0000-000000000000",
        "sync_fields": [
            "status",
        ],
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())