Sign in

v1

latestOpenAPI 3.0.32026-07-264616.2 KB

Resume Crew Execution with Human Feedback

📋 Reference Example Only - This shows the request format. To test with your actual crew, copy the cURL example and replace the URL + token with your real values.

Resume a paused crew execution with human feedback for Human-in-the-Loop (HITL) workflows. When a task with human_input=True completes, the crew execution pauses and waits for human feedback.

IMPORTANT: You must provide the same webhook URLs (taskWebhookUrl, stepWebhookUrl, crewWebhookUrl) that were used in the original kickoff call. Webhook configurations are NOT automatically carried over - they must be explicitly provided in the resume request to continue receiving notifications.

post/resume

Request body

execution_idstring uuid required

The unique identifier for the crew execution (from kickoff)

task_idstring required

The ID of the task that requires human feedback

human_feedbackstring required

Your feedback on the task output. This will be incorporated as additional context for subsequent task executions.

is_approveboolean required

Whether you approve the task output: true = positive feedback (continue), false = negative feedback (retry task)

taskWebhookUrlstring uri

Callback URL executed after each task completion. MUST be provided to continue receiving task notifications.

stepWebhookUrlstring uri

Callback URL executed after each agent thought/action. MUST be provided to continue receiving step notifications.

crewWebhookUrlstring uri

Callback URL executed when the crew execution completes. MUST be provided to receive completion notification.

Example request

{
  "execution_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "task_id": "research_task",
  "human_feedback": "Great research! Please add more details about recent developments in the field.",
  "is_approve": true,
  "taskWebhookUrl": "https://your-server.com/webhooks/task",
  "stepWebhookUrl": "https://your-server.com/webhooks/step",
  "crewWebhookUrl": "https://your-server.com/webhooks/crew"
}

Response

Execution resumed successfully

status'resumed' | 'retrying' | 'completed'

Status of the resumed execution

messagestring

Human-readable message about the resume operation

Example response

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