---
title: "Start Crew Execution"
method: POST
path: "/kickoff"
---

# Start Crew Execution

`POST /kickoff`

**📋 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

- object
  - `inputs` object, required — Key-value pairs of all required inputs for your crew
  - `meta` object — Additional metadata to pass to the crew
  - `taskWebhookUrl` string, uri — Callback URL executed after each task completion
  - `stepWebhookUrl` string, uri — Callback URL executed after each agent thought/action
  - `crewWebhookUrl` string, uri — Callback URL executed when the crew execution completes

## Response `200`

Crew execution started successfully

- object
  - `kickoff_id` string, uuid — Unique identifier for tracking this execution

## Other responses

- `400` — Invalid request body or missing required inputs
- `401` — Authentication failed - check your bearer token
- `422` — Validation error - ensure all required inputs are provided
- `500` — Internal server error

---

[API](https://skmtc.dev/crewai/apis/crewai-amp-api.md) · [All operations](https://skmtc.dev/crewai/apis/crewai-amp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crewai/crewai-amp-api/revisions/ee5ac53a62cc/schema)