Axuz Developers

GET /teams/{teamId}/boards/{id}/statuses

Lista os status do board (ordenados por position)

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

200 {items} ordenados por position. Onde: UI de status/board settings.

listBoardStatusesHandler — GET /teams/{t}/boards/{id}/statuses.

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
idpathstringsim

Respostas

200

ok

NomeTipoObrigatórioDescrição
itemsarray<BoardStatus>sim
items[].idstring<uuid>sim
items[].team_idstring<uuid>sim
items[].board_idstring<uuid>sim
items[].namestringsim
items[].colorstringsim

token da paleta fechada (slate gray red orange amber yellow lime green teal cyan blue indigo violet purple pink rose) ou hex #RRGGBB (normalizado para minusculas)

items[].categorystringsim

enum: "todo", "doing", "done", "cancelled"

items[].positionintegersim
items[].linked_column_idstring<uuid> | nullsim
items[].is_defaultbooleansim
items[].created_atstring<date-time>sim
items[].updated_atstring<date-time>sim

401

sem sessao

403

nao e membro do team (ou membro de outro tenant)

404

board inexistente, de outro team ou de canal sem escopo tasks

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Erro interno. Tente de novo com backoff; reporte o X-Request-Id.

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 GET 'https://api-workspace.axuz.net/teams/TEAM_ID/boards/ID/statuses' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

const res = await fetch("https://api-workspace.axuz.net/teams/TEAM_ID/boards/ID/statuses", {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
  },
});
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(
    "GET",
    "https://api-workspace.axuz.net/teams/TEAM_ID/boards/ID/statuses",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())