OpenAPI Reference: Publishing

Todos os endpoints abaixo exigem header Authorization: Bearer fc_live_.... Veja REST API pra criar a chave.

Base URL: https://app.falacheese.com.br/api/v1

POST /posts — Criar post

Cria um post (rascunho, agendado ou publica imediatamente).

POST /api/v1/posts
Content-Type: application/json

{
  "body": "Texto do post.",
  "socialAccountIds": ["acc_xyz"],
  "mediaIds": ["med_123"],          // opcional
  "firstComment": "...",             // opcional
  "scheduledAt": "2026-06-01T12:00:00Z",  // opcional (ISO 8601 UTC)
  "publishNow": false,               // opcional
  "poll": {                          // opcional, só LinkedIn
    "question": "...",
    "options": ["A", "B"],
    "durationDays": 7
  }
}

Resposta 201:

{
  "ok": true,
  "post": {
    "id": "post_abc",
    "body": "...",
    "status": "scheduled",
    "createdAt": "..."
  },
  "publishResults": [
    { "socialAccountId": "acc_xyz", "status": "fulfilled" }
  ]
}

Erros:

400 — payload inválido
401 — sem auth
402 — quota excedida ou plano não permite (free não publica auto)
404 — socialAccountId não existe ou não pertence à workspace ativa

GET /posts — Listar posts

GET /api/v1/posts?status=scheduled&limit=20&cursor=...

Filtros suportados:

status — draft, scheduled, publishing, published, failed, cancelled
platform — linkedin, instagram, whatsapp
from, to — ISO 8601, filtra por scheduledAt
limit — máximo 100 (default 20)
cursor — pagination cursor da resposta anterior

Resposta:

{
  "posts": [...],
  "nextCursor": "...",  // null se for última página
  "total": 1234
}

GET /posts/:id — Detalhe do post

GET /api/v1/posts/post_abc

Retorna o post completo + array de scheduledPosts com status por plataforma + external IDs após publicação.

PATCH /posts/:id — Atualizar rascunho

Só funciona em posts com status draft ou scheduled que ainda não entraram em cron window.

PATCH /api/v1/posts/post_abc
Content-Type: application/json

{
  "body": "Novo texto",
  "scheduledAt": "2026-06-05T10:00:00Z"
}

Campos editáveis: body, mediaIds, firstComment, scheduledAt, poll.

DELETE /posts/:id — Cancelar/excluir

Em draft → exclui do banco
Em scheduled → cancela cron, marca como cancelled (não deleta — fica em log)
Em published → não deleta no LinkedIn/IG (precisa ir lá manualmente). Marca como cancelled no Fala Cheese só pra organização

POST /posts/:id/publish-now — Publicar rascunho imediatamente

POST /api/v1/posts/post_abc/publish-now

Pega rascunho existente e dispara publicação imediata. Útil pra fluxo onde você cria draft via API, revisa via UI, e publica via API depois.

Rate limits

30 req/min
1000 req/dia

429 com Retry-After quando bate teto. Distribui chamadas em vez de burst.

SDK / clients

Não temos SDK oficial ainda. Mas a spec OpenAPI 3.1 em /api/openapi permite gerar client em qualquer linguagem com openapi-generator-cli.

Veja n8n integration e Make scenarios pra setup sem código.