> ## Documentation Index
> Fetch the complete documentation index at: https://crewai-luzk-remove-log-format-ff-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /kickoff

> Iniciar a execução da crew



## OpenAPI

````yaml enterprise-api.pt-BR.yaml POST /kickoff
openapi: 3.0.3
info:
  title: CrewAI AMP API
  description: >
    REST API para interagir com suas crews implantadas no CrewAI AMP.


    ## Introdução


    1. **Encontre a URL da sua crew**: Obtenha sua URL única no painel do CrewAI
    AMP

    2. **Copie os exemplos**: Use os exemplos de cada endpoint como modelo

    3. **Substitua os placeholders**: Atualize URLs e tokens com seus valores
    reais

    4. **Teste com suas ferramentas**: Use cURL, Postman ou seu cliente
    preferido


    ## Autenticação


    Todas as requisições exigem um token bearer. Existem dois tipos:


    - **Bearer Token**: Token em nível de organização para operações completas

    - **User Bearer Token**: Token com escopo de usuário com permissões
    limitadas


    Você encontra os tokens na aba Status da sua crew no painel do CrewAI AMP.


    ## Documentação de Referência


    Este documento fornece exemplos completos para cada endpoint:


    - **Formatos de requisição** com parâmetros obrigatórios e opcionais

    - **Exemplos de resposta** para sucesso e erro

    - **Amostras de código** em várias linguagens

    - **Padrões de autenticação** com uso correto de Bearer token


    Copie os exemplos e personalize com sua URL e tokens reais.


    ## Fluxo


    1. **Descubra os inputs** usando `GET /inputs`

    2. **Inicie a execução** usando `POST /kickoff`

    3. **Monitore o progresso** usando `GET /status/{kickoff_id}`
  version: 1.0.0
  contact:
    name: CrewAI Suporte
    email: support@crewai.com
    url: https://crewai.com
servers:
  - url: https://your-actual-crew-name.crewai.com
    description: Substitua pela URL real da sua crew no painel do CrewAI AMP
security:
  - BearerAuth: []
paths:
  /kickoff:
    post:
      summary: Iniciar Execução da Crew
      description: >
        **📋 Exemplo de Referência** - *Mostra o formato da requisição. Para
        testar com sua crew real, copie o cURL e substitua URL + token.*


        Inicia uma nova execução da crew com os inputs fornecidos e retorna um
        kickoff ID.
      operationId: startCrewExecution
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - inputs
              properties:
                inputs:
                  type: object
                  additionalProperties:
                    type: string
                  example:
                    budget: 1000 USD
                    interests: games, tech, ai, relaxing hikes, amazing food
                    duration: 7 days
                    age: '35'
      responses:
        '200':
          description: Execução iniciada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  kickoff_id:
                    type: string
                    format: uuid
                    example: abcd1234-5678-90ef-ghij-klmnopqrstuv
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  responses:
    UnauthorizedError:
      description: Autenticação falhou
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: Erro interno do servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        **📋 Referência** - *Os tokens mostrados são apenas exemplos.*
        Use seus tokens reais do painel do CrewAI AMP.

````