A API pública deixa outros sistemas trabalharem no seu workspace sem entrar como uma pessoa. Um fluxo do n8n cria a tarefa quando a gravação termina, um script puxa as horas do mês passado, um formulário registra o que o cliente aprovou pelo WhatsApp.
Ela é a outra metade dos webhooks: o webhook avisa suas ferramentas que algo aconteceu no RecReview; a API deixa suas ferramentas agirem no RecReview.
Antes de começar: a API exige assinatura Studio paga — não vale no Creator, no Pro nem no período de teste. Só donos e admins do workspace criam chaves.
Criar uma chave
- Clique no seu avatar, no canto superior direito, e escolha Configurações do Workspace.
- Em Avançado, abra a aba API.
- Clique em Nova chave.
- Dê um Nome, como
n8n — gravações. É esse nome que aparece como autor de tudo o que a chave fizer. - Em Permissões, marque só o que a automação usa.
- Em Expira, escolha Nunca, Em 30 dias, Em 90 dias ou Em 1 ano.
- Clique em Criar chave.
- Copie a chave em Copie sua chave agora e guarde na sua ferramenta de automação. Depois clique em Já guardei.
Atenção: é a única vez que a chave completa aparece. O RecReview não consegue mostrá-la de novo. Se perder, crie outra e revogue a antiga.
Cada workspace pode ter até 20 chaves ativas ao mesmo tempo. Chaves revogadas ou expiradas não contam.
Permissões
A chave só faz o que você marcou. O resto é recusado.
| Permissão | O que libera |
|---|---|
| Criar tarefas | Criar tarefas de vídeo e de galeria de fotos |
| Ler tarefas | Listar tarefas e ler uma tarefa, com versões e links |
| Atualizar tarefas (status, prazos, responsável, links) | Mudar título, descrição, status, fase, bloqueio, responsável, prazos, tags e estimativa, e anexar links |
| Ler comentários de revisão | Ler comentários e respostas de uma versão, inclusive os só da equipe |
| Registrar o veredito do cliente | Registrar que o cliente aprovou ou pediu alterações fora do app |
| Ler horas registradas | Ler as horas lançadas pela equipe |
| Ler clientes / Criar clientes | Listar clientes / cadastrar um cliente novo |
| Ler projetos / Criar projetos | Listar projetos / cadastrar um projeto novo |
| Ler membros (para o responsável) | Listar nome e e-mail de quem pode ser responsável por uma tarefa |
| Ler status, fases e bloqueios | Ler o seu fluxo de trabalho, para a automação usar as chaves certas |
Não dá para trocar o cliente ou o projeto de uma tarefa pela API: isso mudaria o código do vídeo e o portal onde a tarefa aparece.
Usar a chave
Toda requisição vai para https://rec.review/api/v1 e leva a chave no cabeçalho Authorization:
Authorization: Bearer rr_live_...
O corpo de envio e de resposta é JSON. Campos que a API não conhece são recusados, então um erro de digitação não passa batido.
Para conferir se a chave funciona, chame GET /me. A resposta traz o nome da chave, as permissões e o workspace a que ela pertence. Cada chave é de um workspace só, então você nunca informa o id do workspace.
Exemplo: criar uma tarefa
curl -X POST https://rec.review/api/v1/tasks \
-H "Authorization: Bearer $RECREVIEW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: gravacao-1234" \
-d '{
"title": "Edição — Aula 3",
"projectId": "<id do projeto>",
"dueDate": "2026-10-30T15:00:00.000Z",
"attachments": [
{ "type": "link", "name": "Transcrição", "url": "https://drive.google.com/..." }
]
}'
A tarefa passa pelas mesmas checagens e pelas mesmas automações de Tarefa criada de uma tarefa criada no app. Mande "kind": "gallery" para criar uma tarefa de galeria de fotos.
O cabeçalho Idempotency-Key é opcional, mas vale mandar. Monte o valor a partir do evento que disparou a automação. Se a mesma requisição chegar duas vezes, o RecReview devolve a tarefa que já criou em vez de duplicar.
Outras chamadas úteis
| Chamada | Permissão |
|---|---|
GET /tasks — lista tarefas, com filtro por cliente, projeto, status, fase, responsável ou texto |
Ler tarefas |
PATCH /tasks/:id — atualiza a tarefa; mudar o status roda as suas automações |
Atualizar tarefas |
GET /tasks/:id/comments — comentários da versão mais recente |
Ler comentários de revisão |
POST /tasks/:id/verdict — approved ou changes_requested, com o canal (whatsapp, email, meeting ou other) |
Registrar o veredito do cliente |
GET /time-entries?from=...&to=... — horas num intervalo de datas |
Ler horas registradas |
GET /workflow — as chaves de status, fases e bloqueios |
Ler status, fases e bloqueios |
Registrar o veredito pela API tem o mesmo efeito de registrar pela tela de revisão: solta o bloqueio de cliente, roda as automações e, na aprovação, manda o e-mail de entrega final e o webhook video.delivery_approved. Só vale para a versão mais recente.
Deixe a chave fora de vista
No n8n, guarde a chave como credencial Header Auth — nome Authorization, valor Bearer rr_live_... — e selecione essa credencial no nó HTTP Request. Não cole a chave direto num nó ou numa expressão: ela vazaria em workflows exportados e no histórico de execuções.
Limites
- 120 requisições por minuto por chave.
- 2.000 tarefas criadas pela API por workspace a cada 24 horas.
- Muitas tentativas de autenticação com erro vindas do mesmo endereço ficam bloqueadas por alguns minutos.
Passou do limite, a resposta é um erro 429. Espere e tente de novo.
O rastro que a chave deixa
Tudo o que a chave faz leva o nome dela. No histórico da tarefa, o autor aparece como o nome da chave seguido de (API) — por exemplo, n8n — gravações (API) —, então qualquer pessoa da equipe sabe o que veio de uma automação.
A aba API lista cada chave com as permissões, quem criou, o Último uso e quando expira.
Quando a chave para de funcionar
- Revogada. Clique em Revogar na chave e confirme em Revogar chave. As automações que usam a chave param na hora. Não dá para desfazer.
- Expirada. A data de expiração que você escolheu passou.
- Quem criou deixou de ser admin. A chave só vale enquanto quem a criou continua dono ou admin do workspace. Se a pessoa for removida, arquivada, suspensa ou mudar de papel, a chave aparece como Inativa. Um admin precisa criar outra.
- O plano mudou. Se o workspace sair do Studio, ou a assinatura for cancelada, ficar sem pagamento ou pausada, todas as chaves param até a assinatura voltar. Pagamento atrasado que ainda está sendo cobrado de novo não para as chaves.
Requisições recusadas trazem um código de erro — como api_key_revoked, api_key_expired, api_key_creator_inactive, insufficient_scope ou plan_required —, para a sua automação saber em qual caso caiu.