Axuz Developers

POST /teams/{teamId}/flowcharts/{id}/share

Grava public_share_token (single-token model).

  • Access: Team member
  • Service: https://api-flow.axuz.net

Accepted authentication

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

Serve POST /teams/{teamId}/flowcharts/{id}/share — grava um public_share_token no flowchart (schema legado single-token).

POR QUE FICA: os links /public/flowcharts/{token} já foram enviados a terceiros e a coluna flowcharts.public_share_token ainda tem linhas preenchidas — desmontar a rota quebra share vivo de usuário. CONDIÇÃO DE SAÍDA: quando public_share_token IS NOT NULL for zero em produção (ou os tokens tiverem sido migrados pra tabela shares). Novos shares multi-mode vão em POST /shares (handler_shares.go).

Entradas: URL {teamId}/{id}, JWT, body opcional {expires_at}.

Retorno: 200 {token, url, expires_at}; 404 se flowchart inexistente.

Parameters

NameInTypeRequiredDescription
teamIdpathstringyes
idpathstringyes

Request body

application/json

NameTypeRequiredDescription
expires_atstring<date-time> | nullno
{
  "expires_at": "2026-01-15T12:00:00Z"
}

Responses

200

Token gerado.

NameTypeRequiredDescription
tokenstringyes
urlstringyes
expires_atstring<date-time> | nullno

401

JWT ausente/expirado.

NameTypeRequiredDescription
errorstringyes

403

Sem permissao (nao e owner/admin; token sem escopo; token de integracao em rota nao permitida)

NameTypeRequiredDescription
errorstringyes

404

Recurso não encontrado ou fora de escopo.

NameTypeRequiredDescription
errorstringyes

429

Limite de requisições excedido.

NameTypeRequiredDescription
errorstringyes

500

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

NameTypeRequiredDescription
errorstringyes

Examples

"Try it" is turned off in this reference. Use the examples with your test credential.

curl

curl -sS -X POST 'https://api-flow.axuz.net/teams/TEAM_ID/flowcharts/ID/share' \
  -H "Authorization: Bearer $AXUZ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expires_at":"2026-01-15T12:00:00Z"}'

Node.js

const res = await fetch("https://api-flow.axuz.net/teams/TEAM_ID/flowcharts/ID/share", {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "expires_at": "2026-01-15T12:00:00Z"
  }),
});
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-flow.axuz.net/teams/TEAM_ID/flowcharts/ID/share",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    json={
        "expires_at": "2026-01-15T12:00:00Z",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())