API: conectar o Zapier, o Make e seus sistemas

Criar uma chave

1. Abra Configurações da empresa › Integrações › API. Só donos e admins veem essa parte.
2. Toque em Criar chave, dê um nome (por exemplo, Zapier) e escolha Só leitura ou Leitura e escrita.
3. Copie a chave na hora e guarde num lugar seguro: ela aparece uma vez só. O gridOS guarda apenas o começo dela (gk_live_a1b2…), para você reconhecer na lista.

Se uma chave vazar ou não for mais usada, toque em Revogar. Os apps que usam essa chave param de funcionar na hora. Não dá para desfazer, mas você pode criar outra.

Endereço e autenticação

Todas as chamadas vão para:

https://pookurdrdvkpvnmwlwch.supabase.co/functions/v1/api/v1/

Mande a chave no cabeçalho Authorization: Bearer gk_live_…. As respostas são JSON, com os campos em camelCase (por exemplo, dueDate e companyId). Uma lista vem como {"data": [...], "next": ...}; um item, como {"data": {...}}.

O que dá para fazer

Ler (qualquer chave):

• GET clients · GET clients/{id}: clientes
• GET projects · GET projects/{id}: projetos (filtros: companyId, status)
• GET tasks · GET tasks/{id}: tarefas (filtros: projectId, status = todo, doing ou done, updatedSince)
• GET invoices · GET invoices/{id}: faturas (filtros: status, companyId, projectId)
• GET proposals · GET proposals/{id}: propostas

Criar e mudar (chave de leitura e escrita):

• POST clients: name, e se quiser email, phone, contact. O cliente entra como prospecto.
• POST projects: name e companyId (sem cliente, vira projeto interno).
• POST tasks: title, e se quiser projectId, dueDate e assigneeEmail (o e-mail de alguém do estúdio).
• PATCH tasks/{id}: title, status (todo, doing ou done) e dueDate (null tira a data).

Datas no formato 2026-10-25. Exemplo, criar uma tarefa:

curl -X POST https://pookurdrdvkpvnmwlwch.supabase.co/functions/v1/api/v1/tasks \
  -H "Authorization: Bearer gk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Revisar logo", "dueDate": "2026-10-25", "assigneeEmail": "ana@estudio.com"}'

Páginas, limites e erros

• As listas vêm das mais novas para as mais antigas, 50 por vez (até 100 com limit=100). Quando há mais, a resposta traz next: mande de volta como cursor=… para pegar a página seguinte. Também dá para usar offset.
• Até 120 chamadas por minuto por chave. Acima disso, a resposta é 429: espere um pouco e tente de novo.
• Até 20 chaves ativas por estúdio.
• Erros vêm como {"error": {"code": ..., "message": ...}}: 401 chave errada ou revogada, 403 chave só de leitura tentando mudar algo, 404 não encontrado, 400 algum campo errado.

Zapier e Make

Use as duas peças juntas:

• Para começar quando algo acontece no gridOS (proposta aceita, fatura paga, cliente novo…), use os webhooks em Integrações › Avançado. No Zapier, o gatilho Webhooks by Zapier › Catch Hook; no Make, o módulo Webhooks › Custom webhook. Cole o endereço que eles derem num webhook novo do gridOS.
• Para fazer algo no gridOS (criar um cliente, uma tarefa…), use a API. No Zapier, a ação Webhooks by Zapier › Custom Request; no Make, o módulo HTTP › Make a request. Ponha o endereço com o caminho (por exemplo, …/api/v1/tasks), o método, o cabeçalho Authorization e o corpo em JSON.

Crie uma chave para cada ferramenta. Assim, se precisar revogar uma, as outras continuam funcionando.