POST /kickoff

POST/kickoff

Start Crew Execution

**📋 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.* Initiates a new crew execution with the provided inputs. Returns a kickoff ID that can be used to track the execution progress and retrieve results. Crew executions can take anywhere from seconds to minutes depending on their complexity. Consider using webhooks for real-time notifications or implement polling with the status endpoint.

Request body

application/jsonobject

travel_planning

{
  "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"
  }
}

outreach_campaign

{
  "inputs": {
    "name": "John Smith",
    "title": "CTO",
    "company": "TechCorp",
    "industry": "Software",
    "our_product": "AI Development Platform",
    "linkedin_url": "https://linkedin.com/in/johnsmith"
  },
  "taskWebhookUrl": "https://api.example.com/webhooks/task",
  "crewWebhookUrl": "https://api.example.com/webhooks/crew"
}

Responses

200Crew execution started successfully

application/json

400Invalid request body or missing required inputs

application/json

401Authentication failed - check your bearer token

application/json

422Validation error - ensure all required inputs are provided

application/json

500Internal server error

application/json