> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /kickoff

> 크루 실행 시작



## OpenAPI

````yaml v1.15.39/enterprise-api.ko.yaml POST /kickoff
openapi: 3.0.3
info:
  title: CrewAI 엔터프라이즈 API
  description: |
    CrewAI AOP에 배포된 crew와 상호작용하기 위한 REST API입니다.

    ## 시작하기
    1. **Crew URL 확인**: 대시보드에서 고유한 crew URL을 확인하세요
    2. **예제 복사**: 각 엔드포인트의 예제를 템플릿으로 사용하세요
    3. **플레이스홀더 교체**: 실제 URL과 토큰으로 바꾸세요
    4. **도구로 테스트**: cURL, Postman 등 선호하는 도구로 테스트하세요
  version: 1.0.0
  contact:
    name: CrewAI 지원
    email: support@crewai.com
    url: https://crewai.com
servers:
  - url: https://your-actual-crew-name.crewai.com
    description: 대시보드의 실제 crew URL로 교체하세요
security:
  - BearerAuth: []
paths:
  /kickoff:
    post:
      summary: Crew 실행 시작
      description: |
        **📋 참조 예제만 제공** - *요청 형식을 보여줍니다. 실제 호출은 cURL 예제를 복사해 URL과 토큰을 교체하세요.*

        제공된 입력으로 새로운 실행을 시작하고 kickoff ID를 반환합니다.
      operationId: startCrewExecution
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - inputs
              properties:
                inputs:
                  type: object
                  additionalProperties:
                    type: string
      responses:
        '200':
          description: 실행이 성공적으로 시작됨
          content:
            application/json:
              schema:
                type: object
                properties:
                  kickoff_id:
                    type: string
                    format: uuid
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '422':
          description: >-
            검증 오류: 필수 입력이 누락되었거나, 에이전트의 앱이 CrewAI AMP에 연결되어 있지 않습니다. User Bearer
            Token으로 요청하면 실행이 시작되기 전에 앱을 확인합니다. 이 확인에서 걸러지지 않은 앱은 실행을 실패시키며, `GET
            /status/{kickoff_id}`가 해당 앱을 알려줍니다.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ValidationError'
                  - type: object
                    properties:
                      detail:
                        $ref: '#/components/schemas/AppsNotConnected'
              examples:
                apps_not_connected:
                  summary: 에이전트의 앱이 CrewAI AMP에 연결되어 있지 않음
                  value:
                    detail:
                      code: apps_not_connected
                      message: >-
                        Agent 'Asana Workspace Scout' needs apps that are not
                        connected in AMP: asana
                      agent: Asana Workspace Scout
                      missing_apps:
                        - asana
        '500':
          $ref: '#/components/responses/ServerError'
components:
  responses:
    UnauthorizedError:
      description: 인증 실패
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: 서버 내부 오류
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    ValidationError:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        details:
          type: object
          properties:
            missing_inputs:
              type: array
              items:
                type: string
    AppsNotConnected:
      type: object
      description: 에이전트의 앱이 CrewAI AMP에 연결되어 있지 않거나, CrewAI AMP가 알지 못하는 앱입니다.
      properties:
        code:
          type: string
          enum:
            - apps_not_connected
          description: 항상 `apps_not_connected`
        message:
          type: string
          description: 사람이 읽을 수 있는 오류 메시지
          example: >-
            Agent 'Asana Workspace Scout' needs apps that are not connected in
            AMP: asana
        agent:
          type: string
          description: 앱을 선언한 에이전트의 역할
          example: Asana Workspace Scout
        missing_apps:
          type: array
          items:
            type: string
          description: CrewAI AMP에서 연결해야 할 앱 (CrewAI AMP가 표시하는 이름)
          example:
            - asana
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        **📋 참고** - *예시의 토큰은 자리 표시자입니다.* 실제 토큰을 사용하세요.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.