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.
Uma única API REST para retrospectivas, verificações de integridade, ações e equipes
Incorpore resumos do Retro aos seus relatórios, sincronize ações com seu rastreador, aloque 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"O que você pode construir
Equipes e pessoas
Liste e gerencie equipes, membros e funções. Crie 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 análise de integridade e de estimativa, além de modelos de integridade, para alimentar seus relatórios.
Exportações de relatórios
Baixar arquivos CSV — atividades da equipe, atividades de ação, atividades de retrospectiva e de avaliação de desempenho, 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 política que aplicamos 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. Aponte o TeamRetro para um endpoint e nós enviaremos um evento assinado assim que houver alguma alteração — quando um retro ou uma verificação de integridade for concluído, quando uma ação for criada, reatribuída ou encerrada, quando um acordo for alterado, quando um membro ingressar 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. Escolha os eventos, defina seu endpoint, obtenha um segredo de assinatura gerado automaticamente e envie um evento de teste.
Assinado e verificável
Cada entrega contém 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 1m, 5m, 30m e 2h) antes que um endpoint com falha seja pausado.
Desenvolvido também para agentes de IA
Introdução rápida
Liste as ações em aberto 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 referência completa — todos os recursos, filtros e campos — está disponível em developer.teamretro.com/docs.
Perguntas e respostas
Quem pode usar a API?
Como faço para me autenticar?
Authorization: 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?
Existe alguma opção de IA/MCP?
Onde estão os documentos completos da API?
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).
-
Conformidade com a 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 SLAs de resposta rápida para garantir que suas equipes permaneçam produtivas e recebam todo o apoio necessário. Painel de status