POST /resume

POST /resume

멈춰 있던 crew 실행을 사람의 피드백과 함께 재개하는 엔드포인트예요. 실행 ID와 태스크 ID, 피드백을 넘겨주면 해당 태스크의 승인/수정 여부에 따라 실행이 이어져요.

출처: 문서

본문

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

curl 예시:

curl --request POST \
  --url https://your-actual-crew-name.crewai.com/resume \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --data '
{
  "execution_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "task_id": "research_task",
  "human_feedback": "Excellent research! Proceed to the next task.",
  "is_approve": true,
  "taskWebhookUrl": "https://api.example.com/webhooks/task",
  "stepWebhookUrl": "https://api.example.com/webhooks/step",
  "crewWebhookUrl": "https://api.example.com/webhooks/crew"
}
'

성공 응답 예시:

{
  "status": "resumed",
  "message": "Execution resumed successfully"
}

Authorizations (인증)

Authorization string header, 필수입니다.

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

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

Body (application/json)

• execution_id string<uuid> (필수) — crew 실행의 고유 식별자예요 (kickoff에서 받은 값). 예시: "abcd1234-5678-90ef-ghij-klmnopqrstuv"
• task_id string (필수) — 사람 피드백이 필요한 태스크의 ID예요. 예시: "research_task"
• human_feedback string (필수) — 태스크 출력에 대한 피드백이에요. 이후 태스크 실행의 추가 컨텍스트로 반영돼요. 예시: "Great research! Please add more details about recent developments in the field."
• is_approve boolean (필수) — 태스크 출력을 승인하는지 여부예요. true = 긍정 피드백(계속 진행), false = 부정 피드백(태스크 재시도). 예시: true
• 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 (응답)

Execution resumed successfully

• status enum<string> — 재개된 실행의 상태예요. 가능한 값: resumed, retrying, completed. 예시: "resumed"
• message string — resume 작업에 대한 사람이 읽을 수 있는 메시지예요. 예시: "Execution resumed successfully"

더 알아보기 (Learn more)

• POST /kickoff
• GET /status/{kickoff_id}