Introdução

Referência completa para a API REST do CrewAI AMP

​

CrewAI AMP API

Bem-vindo à referência da API do CrewAI AMP. Esta API permite que você interaja programaticamente com seus crews implantados, possibilitando a integração com seus aplicativos, fluxos de trabalho e serviços.

​

Início Rápido

1. Obtenha suas credenciais de API

   Navegue até a página de detalhes do seu crew no painel do CrewAI AMP e copie seu Bearer Token na aba Status.

2. Descubra os Inputs Necessários

   Use o endpoint GET /inputs para ver quais parâmetros seu crew espera.

3. Inicie uma Execução de Crew

   Chame POST /kickoff com seus inputs para iniciar a execução do crew e receber um kickoff_id.

4. Monitore o Progresso

   Use GET /status/{kickoff_id} para checar o status da execução e recuperar os resultados.

​

Autenticação

Todas as requisições à API exigem autenticação usando um Bearer token. Inclua seu token no header Authorization:

curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \
  https://your-crew-url.crewai.com/inputs

​

Tipos de Token

Tipo de Token	Escopo	Caso de Uso
Bearer Token	Acesso em nível de organização	Operações completas de crew, ideal para integração server-to-server
User Bearer Token	Acesso com escopo de usuário	Permissões limitadas, adequado para operações específicas de usuário

Você pode encontrar ambos os tipos de token na aba Status da página de detalhes do seu crew no painel do CrewAI AMP.

​

URL Base

Cada crew implantado possui um endpoint de API único:

https://your-crew-name.crewai.com

Substitua your-crew-name pela URL real do seu crew no painel.

​

Fluxo Típico

1. Descoberta: Chame GET /inputs para entender o que seu crew precisa
2. Execução: Envie os inputs via POST /kickoff para iniciar o processamento
3. Monitoramento: Faça polling em GET /status/{kickoff_id} até a conclusão
4. Resultados: Extraia o output final da resposta concluída

​

Tratamento de Erros

A API utiliza códigos de status HTTP padrão:

Código	Significado
200	Sucesso
400	Requisição Inválida - Formato de input inválido
401	Não Autorizado - Bearer token inválido
404	Não Encontrado - Recurso não existe
422	Erro de Validação - Inputs obrigatórios ausentes
500	Erro no Servidor - Contate o suporte

​

Testes Interativos

Por que não há botão “Enviar”? Como cada usuário do CrewAI AMP possui sua própria URL de crew, utilizamos o modo referência em vez de um playground interativo para evitar confusão. Isso mostra exatamente como as requisições devem ser feitas, sem botões de envio não funcionais.

Cada página de endpoint mostra para você:

• ✅ Formato exato da requisição com todos os parâmetros
• ✅ Exemplos de resposta para casos de sucesso e erro
• ✅ Exemplos de código em várias linguagens (cURL, Python, JavaScript, etc.)
• ✅ Exemplos de autenticação com o formato adequado de Bearer token

​

Para testar sua API de verdade:

Copie Exemplos cURL

Copie os exemplos cURL e substitua a URL + token por seus valores reais

Use Postman/Insomnia

Importe os exemplos na sua ferramenta de testes de API preferida

Exemplo de fluxo:

1. Copie este exemplo cURL de qualquer página de endpoint
2. Substitua your-actual-crew-name.crewai.com pela URL real do seu crew
3. Substitua o Bearer token pelo seu token real do painel
4. Execute a requisição no seu terminal ou cliente de API

​

Precisa de Ajuda?

Suporte Enterprise

Obtenha ajuda com integração da API e resolução de problemas

Painel Enterprise

Gerencie seus crews e visualize logs de execução