Atualizar card
Rota de Quadros da API aberta da Astrify Flows: parâmetros, exemplos em curl, Node.js e Python, resposta e erros.
PATCHhttps://api2.astrify.com.br/v1/quadros/cards/{card_id}
Escopo: quadros:write · Área: Quadros · Testar no navegador
Parâmetros de caminho
| Nome | Tipo | Descrição |
|---|---|---|
card_id obrigatório | string | Id de card. |
Exemplo de requisição
A chave vem da variável de ambiente ASTRIFY_API_KEY. Troque os marcadores em maiúsculas (comoLEAD_ID) por ids da sua empresa.
curl -X PATCH "https://api2.astrify.com.br/v1/quadros/cards/CARD_ID" \ -H "Authorization: Bearer $ASTRIFY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "titulo": "Enviar proposta revisada", "prioridade": "media"}'const res = await fetch('https://api2.astrify.com.br/v1/quadros/cards/CARD_ID', { method: 'PATCH', headers: { Authorization: `Bearer ${process.env.ASTRIFY_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "titulo": "Enviar proposta revisada", "prioridade": "media" }),});console.log(res.status, await res.json());import os, requests
r = requests.patch( "https://api2.astrify.com.br/v1/quadros/cards/CARD_ID", headers={"Authorization": f"Bearer {os.environ['ASTRIFY_API_KEY']}"}, json={ "titulo": "Enviar proposta revisada", "prioridade": "media", }, timeout=20,)print(r.status_code, r.json())Resposta
Status 200, em JSON:
{ "success": true, "card": { "id": "3f9c2b1e-8a4d-4c71-9e0b-5d2a7c6f1b34", "titulo": "Enviar proposta", "descricao": null, "coluna_id": "c4b8f2a9-6d17-4e35-b0a2-91f3d85c7e10", "prioridade": "alta", "data_vencimento": "2026-10-10", "concluido": false, "created_at": "2026-10-01T14:32:10.123456+00:00" }}Erros
| Status | Quando acontece |
|---|---|
401 | Chave ausente, inválida, expirada ou revogada. |
403 | Sem o escopo exigido, cargo sem permissão, IP não autorizado ou registro de outra empresa. |
422 | Corpo ou parâmetro com formato inválido. O detail lista os campos com problema. |
429 | Limite de 120 requisições por minuto da chave. Espere o tempo do cabeçalho Retry-After. |
O formato dos erros e as retentativas estão em Limites de uso e erros.