POST /kickoff

배포된 crew의 실행을 시작하는 엔드포인트예요. 필요한 입력값들을 inputs로 넘겨주면 crew 실행이 시작되고, 추적용 kickoff_id를 반환받아요.

출처: 문서

본문

POST https://your-actual-crew-name.crewai.com/kickoff

curl 예시:

curl --request POST \
  --url https://your-actual-crew-name.crewai.com/kickoff \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": {
    "budget": "1000 USD",
    "interests": "games, tech, ai, relaxing hikes, amazing food",
    "duration": "7 days",
    "age": "35"
  },
  "meta": {
    "requestId": "travel-req-123",
    "source": "web-app"
  }
}
'

성공 응답 예시:

{
  "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv"
}

에러 응답 예시들:

{
  "error": "Authentication Error",
  "message": "Invalid bearer token provided"
}

{
  "error": "Unauthorized",
  "message": "Invalid or missing bearer token"
}

{
  "error": "Validation Error",
  "message": "Missing required inputs",
  "details": {
    "missing_inputs": [
      "budget",
      "interests"
    ]
  }
}

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}

Authorizations (인증)

Authorization string header, 필수입니다.

참고 문서 — 예제에 나온 토큰은 참고용 placeholder일 뿐이에요. 실제 API 호출에는 CrewAI AMP 대시보드에서 발급받은 실제 Bearer Token 또는 User Bearer Token을 사용해야 해요.

Bearer Token: 조직(Organization) 레벨 접근 권한으로, crew 전체 작업을 수행할 수 있어요.
User Bearer Token: 사용자 범위 접근 권한으로, 제한된 권한을 가져요.

Body (`application/json`)

inputs object (필수) — crew에 필요한 모든 입력값의 키-값 쌍이에요. 예시:

{  "budget": "1000 USD",  "interests": "games, tech, ai, relaxing hikes, amazing food",  "duration": "7 days",  "age": "35"}

meta object — crew에 전달할 추가 메타데이터예요. 예시:
```
{  "requestId": "user-request-12345",  "source": "mobile-app"}
```
taskWebhookUrl string<uri> — 각 태스크 완료 후 실행되는 콜백 URL이에요. 예시: "https://your-server.com/webhooks/task"
stepWebhookUrl string<uri> — 각 에이전트 사고/행동 후 실행되는 콜백 URL이에요. 예시: "https://your-server.com/webhooks/step"
crewWebhookUrl string<uri> — crew 실행이 완료될 때 실행되는 콜백 URL이에요. 예시: "https://your-server.com/webhooks/crew"

Response (응답)

Crew execution started successfully — kickoff_id string<uuid> : 이 실행을 추적하기 위한 고유 식별자예요. 예시: "abcd1234-5678-90ef-ghij-klmnopqrstuv"

POST /kickoff

POST /kickoff

본문

Authorizations (인증)

Body (application/json)

Response (응답)

더 알아보기 (Learn more)

Body (`application/json`)