Axuz Developers

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

Cria status (autor do board, admin do team ou admin/moderador do canal)

  • Acesso: Membro com escopo
  • 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`.

201 Status; 400/403/404/409/422 (ver contrato). Onde: UI de status.

createBoardStatusHandler — POST /teams/{t}/boards/{id}/statuses.

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
idpathstringsim

Corpo da requisição

application/json · Obrigatório

NomeTipoObrigatórioDescrição
namestringsim

unico por board sem diferenciar maiuscula

colorstringnão

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)

categorystringsim

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

linked_column_idstring<uuid> | nullnão
{
  "name": "string",
  "color": "string",
  "category": "todo",
  "linked_column_id": "00000000-0000-0000-0000-000000000000"
}

Respostas

201

criado

NomeTipoObrigatórioDescrição
idstring<uuid>sim
team_idstring<uuid>sim
board_idstring<uuid>sim
namestringsim
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)

categorystringsim

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

positionintegersim
linked_column_idstring<uuid> | nullsim
is_defaultbooleansim
created_atstring<date-time>sim
updated_atstring<date-time>sim

400

corpo/cor/categoria/nome invalidos

401

sem sessao

403

nao-membro, ou membro que nao pode gerenciar o board

404

board invisivel

409

nome repetido (status_name_taken) ou coluna ja vinculada a outro status (column_already_linked)

422

coluna de outro board (linked column not in board) ou coluna is_done com status que nao e done (done column requires done status)

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 POST 'https://api-workspace.axuz.net/teams/TEAM_ID/boards/ID/statuses' \
  -H "Authorization: Bearer $AXUZ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","color":"string","category":"todo","linked_column_id":"00000000-0000-0000-0000-000000000000"}'

Node.js

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