Automatize retrospectivas, verificações de integridade e ações com a API do TeamRetro

A API REST e os webhooks do TeamRetro permitem automatizar retrospectivas, verificações de integridade, ações e equipes — além de enviar eventos diretamente para seus próprios sistemas. Também foi desenvolvido para agentes de IA.

Read the API docs Try TeamRetro free

Uma única API REST para retrospectivas, verificações de integridade, ações e equipes

Inclua resumos do Retro nos seus relatórios, sincronize ações com o seu rastreador, crie equipes a partir do seu sistema de RH — seja qual for a necessidade do seu fluxo de trabalho. Faça a autenticação com um token de portador e pronto:

curl https://developer.teamretro.com/api/v1/actions \
  -H "Authorization: Bearer $TEAMRETRO_API_KEY"
Leia a documentação da APIPrefere o chat? Use o servidor MCP

O que você pode construir

Equipes e pessoas

Liste e gerencie equipes, membros e funções. Adicione usuários a partir de seus próprios sistemas.

Ações e acordos

Criar, atualizar e encerrar ações; ler e manter acordos de trabalho.

Reuniões e saúde

Leia metadados retrospectivos, de verificação de integridade e de estimativa, além de modelos de integridade, para alimentar seus relatórios.

Exportação de relatórios

Baixar exportações em CSV — atividades da equipe, atividades de ação, atividades de retrospectiva e de avaliação de saúde, saúde da equipe e usuários.

Autenticação e acesso

Chaves de portador, com escopo

Crie chaves em Configurações → API e SCIM com o escopo Leitura, Gravação ou SCIM. Envie-as como Authorization: Bearer <key>. Revogue qualquer chave assim que for necessário.

Nível de equipe em todos os planos

As chaves com escopo de equipe funcionam em todos os planos. O plano Enterprise oferece chaves válidas para toda a conta e entre equipes, além do provisionamento SCIM — a mesma linha que traçamos para insights entre equipes no MCP. Os proprietários da organização podem desativar o acesso à API e ao MCP para toda a conta a qualquer momento.

Webhooks — saiba assim que acontecer

Não faça consultas. Configure o TeamRetro para um endpoint e nós enviaremos um evento assinado assim que houver alguma alteração — quando uma tarefa retro ou uma verificação de status for concluída, quando uma ação for criada, reatribuída ou encerrada, quando um acordo for alterado, quando um membro se juntar ao grupo ou quando alguém for @mencionado.

{
  "event": "action.completed",
  "timestamp": "2026-06-09T10:30:00.000Z",
  "data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}

Por equipe, autoatendimento

Configure em Equipe → Configurações → Integrações. Selecione os eventos, defina seu endpoint, obtenha um segredo de assinatura gerado automaticamente e envie um evento de teste.

Assinado e verificável

Cada entrega possui umX-TeamRetro-Signature (HMAC-SHA256) e um ID de entrega exclusivo, para que você possa verificar a autenticidade e eliminar duplicatas.

Entrega confiável

Somente HTTPS, tempo limite de 30 segundos e tentativas automáticas (imediata, depois 1 minuto, 5 minutos, 30 minutos e 2 horas) antes que um endpoint com falha seja pausado.

Leia o guia sobre webhooks

Também desenvolvido para agentes de IA

Introdução rápida

Liste as ações pendentes de uma equipe e, em seguida, feche uma delas:

# Find open actions for a team
curl "https://developer.teamretro.com/api/v1/actions?status=open" \
  -H "Authorization: Bearer $TEAMRETRO_API_KEY"

# Mark an action complete
curl -X PATCH https://developer.teamretro.com/api/v1/actions/$ACTION_ID \
  -H "Authorization: Bearer $TEAMRETRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "completed" }'

A documentação completa — incluindo todos os recursos, filtros e campos — está disponível em developer.teamretro.com/docs.

Perguntas e respostas

Quem pode usar a API?
As chaves de API para equipes estão disponíveis em todos os planos. O plano Enterprise oferece chaves válidas para toda a conta e para todas as equipes, além do provisionamento SCIM. Crie e revogue chaves em Configurações → API e SCIM.
Como faço para me autenticar?
Cada solicitação contém umAuthorization: Bearer <key>cabeçalho. As chaves são atribuídas aos escopos Leitura, Gravação ou SCIM no momento da criação e podem ser revogadas a qualquer momento.
Webhooks ou polling?
Prefira webhooks — O TeamRetro envia um evento assim que algo acontece (uma retrospectiva é concluída, uma ação é criada ou encerrada), para que você não precise fazer consultas. Cada notificação é assinada para que você possa verificar se veio de nós.
Existe uma opção de IA / MCP?
Sim. Se você preferir trabalhar com linguagem natural em vez de escrever código, o servidor TeamRetro MCP conecta o Claude, o ChatGPT e outros assistentes aos mesmos dados.
Onde estão os documentos completos da API?
A documentação completa está disponível em developer.teamretro.com/docs.

Segurança, conformidade e controle de nível empresarial

A TeamRetro possui certificação SOC 2 Tipo 2 concedida por um auditor independente que avaliou nossas políticas, nosso produto, nossa plataforma e nossa infraestrutura de acordo com a Norma sobre Serviços de Garantia (ASAE 3150).

SOLICITAR SOC 2 ATRAVÉS DO TRUST CENTER BAIXAR SOC 3
SOC 2 Type 2 SOC 3

  • Conformidade com o LGPD e hospedagem regional (EUA e UE)

  • Autenticação única (SSO) via SAML

  • SCIM para provisionamento escalável de usuários

  • Registros de auditoria disponíveis mediante solicitação

Mantemos um tempo de atividade de 99,9%, com acordos de nível de serviço (SLA) de resposta rápida para garantir que suas equipes permaneçam produtivas e recebam todo o suporte necessário. Painel de status