---
canonical_url: "https://docs.composio.dev/toolkits/crew_ai"
markdown_url: "https://docs.composio.dev/toolkits/crew_ai.md"
product: "platform"
version: null
last_updated: null
---

# CrewAI

Run deployed CrewAI automations and manage CrewAI AMP SaaS control-plane resources.

- **Category:** ai agents
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `CREW_AI`
- **Version:** 00000000_00

## Tools

### Get Deployment Logs

**Slug:** `CREW_AI_GET_DEPLOYMENT_LOGS`

Return deployment lifecycle logs for a CrewAI deployment UUID to diagnose build or runtime deployment failures.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `crew_uuid` | string | Yes | Crew deployment UUID returned by CREW_AI_LIST_CREW_DEPLOYMENTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Deployment Status

**Slug:** `CREW_AI_GET_DEPLOYMENT_STATUS`

Return the current AMP deployment status for one crew UUID from the SaaS control plane.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `crew_uuid` | string | Yes | Crew deployment UUID returned by CREW_AI_LIST_CREW_DEPLOYMENTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Execution Status

**Slug:** `CREW_AI_GET_EXECUTION_STATUS`

Return the current state, progress, result, or error for a deployed-crew execution started with a kickoff ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kickoff_id` | string | Yes | Execution identifier returned by CREW_AI_START_CREW_EXECUTION. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Required Inputs

**Slug:** `CREW_AI_GET_REQUIRED_INPUTS`

Return the input names required by the connected deployed CrewAI automation before starting an execution.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Crew Deployments

**Slug:** `CREW_AI_LIST_CREW_DEPLOYMENTS`

List CrewAI crew deployments visible to the selected SaaS organization and return their identifiers for status, logs, or redeployment.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Redeploy Crew

**Slug:** `CREW_AI_REDEPLOY_CREW`

Trigger a new deployment of an existing CrewAI automation by UUID; this irreversibly changes the live deployment and may replace its runtime URL or token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `crew_uuid` | string | Yes | Existing CrewAI automation UUID to redeploy, obtained from CREW_AI_LIST_CREW_DEPLOYMENTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resume Crew Execution

**Slug:** `CREW_AI_RESUME_CREW_EXECUTION`

Approve or retry a human-in-the-loop task and resume its paused CrewAI execution. Resuming may continue externally effectful work.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | Task ID from CrewAI's pending human-input notification for the task that should receive the decision. |
| `is_approve` | boolean | Yes | Set true to approve and continue, or false to retry the task using human_feedback. |
| `execution_id` | string | Yes | Kickoff ID returned by CREW_AI_START_CREW_EXECUTION for the execution that is paused for human input. |
| `human_feedback` | string | Yes | Approval context or retry feedback to give the paused task. |
| `crew_webhook_url` | string | No | Original crew webhook URL to keep completion notifications active; CrewAI does not carry it forward automatically. |
| `step_webhook_url` | string | No | Original step webhook URL to keep step notifications active; CrewAI does not carry it forward automatically. |
| `task_webhook_url` | string | No | Original task webhook URL to keep task notifications active; CrewAI does not carry it forward automatically. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Crew Execution

**Slug:** `CREW_AI_START_CREW_EXECUTION`

Start one execution of the connected deployed CrewAI automation and return its kickoff ID for status checks. The automation may perform irreversible external actions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meta` | object | No | Optional metadata to associate with this execution. |
| `inputs` | object | Yes | Input values keyed by the names returned by CREW_AI_GET_REQUIRED_INPUTS. |
| `crew_webhook_url` | string | No | Optional URL notified when the execution completes. |
| `step_webhook_url` | string | No | Optional URL notified after each agent thought or action. |
| `task_webhook_url` | string | No | Optional URL notified after each task completes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |