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
Inclua resumos do Retro em seus relatórios, sincronize ações com seu rastreador, configure 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 contas de 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, de estimativa e de Standups, além de modelos de integridade, para alimentar seus relatórios.
Exportações de relatórios
Baixe arquivos CSV com dados sobre 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, seguindo 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 na hora em 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 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. 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 um (X-TeamRetro-SignatureHMAC-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 novas tentativas automáticas (imediata, depois 1 minuto, 5 minutos, 30 minutos e 2 horas) 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, que abrange todos os recursos, filtros e campos, está disponível em developer.teamretro.com/docs.
Perguntas frequentes
Quem pode usar a API?
Como faço para me autenticar?
Authorization: Bearer <key>cabeçalho. As chaves são definidas com o escopo 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 um relatório SOC 2 Tipo 2. Um auditor independente examinou os controles em nossas políticas, produto, plataforma e infraestrutura, de acordo com as normas de atestado da AICPA. Conheça o TeamRetro para Empresas.
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,99%, com SLAs de resposta rápida para garantir que suas equipes permaneçam produtivas e recebam todo o suporte necessário.Explore o mundo corporativo