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

# Conductor

Conductor is a cloud development platform for creating workspaces, running coding-agent sessions, exchanging messages, and searching session transcripts.

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

## Tools

### Change Workspace State

**Slug:** `CONDUCTOR_CHANGE_WORKSPACE_STATE`

Put a workspace to sleep or archive it. Both actions stop active workspace use; archive is a stronger transition but is documented as restorable. Confirm the intended target and state before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("sleep" | "archive") | Yes | sleep pauses the workspace; archive stops and archives it. Both operations are documented as idempotent. |
| `workspace_id` | string | Yes | Workspace whose lifecycle state to change. |

#### 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 |

### Create Session

**Slug:** `CONDUCTOR_CREATE_SESSION`

Create another agent chat session in an existing workspace. This may start agent/model resources and incur charges; call only when the user explicitly intends a new session.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional session name. |
| `agent` | string ("claude" | "codex" | "cursor" | "acp") | Yes | Agent implementation for this session. |
| `model` | string | No | Documented model id compatible with the selected agent. |
| `effort` | string ("none" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra") | No | Reasoning effort supported by the selected agent and model. |
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used for the returned deep link; omit for the deployment default. |
| `fast_mode` | boolean | No | Enable fast mode when supported by the selected agent and model. |
| `session_id` | string | No | Optional caller-selected session id; omit to let Conductor generate one. |
| `workspace_id` | string | Yes | Workspace in which to create the session. |

#### 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 |

### Create Workspace

**Slug:** `CONDUCTOR_CREATE_WORKSPACE`

Create a cloud workspace and its first agent session. This launches compute and may incur cloud or model charges; call only when the user explicitly intends to create a new workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Environment variables for the workspace. Treat values as sensitive and include only values the user intends to expose to that workspace. |
| `name` | string | No | Optional non-empty workspace name. |
| `agent` | string ("claude" | "codex" | "cursor" | "acp") | No | Agent for the first session; model and effort must be compatible with it. |
| `model` | string | No | Documented Conductor model id compatible with the selected agent. |
| `branch` | string | No | Repository branch to check out; omit for the repository default. |
| `effort` | string ("none" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra") | No | Reasoning effort supported by the selected agent and model. |
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel for the returned deep link; omit for the deployment default. |
| `project_id` | string | No | Existing Conductor project id. Provide exactly one of project_id or repository_url. |
| `session_name` | string | No | Optional non-empty name for the automatically created first session. |
| `repository_url` | string | No | Git repository URL. Provide exactly one of repository_url or project_id. |

#### 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 Current User

**Slug:** `CONDUCTOR_GET_CURRENT_USER`

Return the user and organization represented by the connected Conductor API key. Use this to verify which account the connection acts as.

#### 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 Message

**Slug:** `CONDUCTOR_GET_MESSAGE`

Get one transcript message by id. The content may contain sensitive prompts, agent output, configuration, or provider-specific events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message_id` | string | Yes | Transcript message id to retrieve. |

#### 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 Project

**Slug:** `CONDUCTOR_GET_PROJECT`

Get one Conductor project and its repository remote by project id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Project id returned by List Projects. |

#### 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 Session

**Slug:** `CONDUCTOR_GET_SESSION`

Get one agent session's configuration and current idle, working, or error status in one read. The tool fails unless both records are retrieved and refer to the requested session.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used for the session deep link; omit for the deployment default. |
| `session_id` | string | Yes | Session to inspect. |

#### 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 Workspace

**Slug:** `CONDUCTOR_GET_WORKSPACE`

Get a workspace's metadata and current lifecycle status in one read, including initialization progress or errors. The tool fails unless both records are retrieved and refer to the requested workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used for the workspace deep link; omit for the deployment default. |
| `workspace_id` | string | Yes | Workspace id to inspect. |

#### 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 Messages

**Slug:** `CONDUCTOR_LIST_MESSAGES`

Read one page of a session transcript or incrementally read messages after a known message ID. Returned content may contain sensitive user prompts, agent output, configuration, or provider events; request and expose it only when needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum messages in this page; must be at least 1. |
| `offset` | integer | No | Zero-based transcript offset for page browsing. Mutually exclusive with after_message_id; omit both to start at the beginning. Pass next_offset from the prior offset-mode response to continue. |
| `session_id` | string | Yes | Session whose potentially sensitive transcript messages to read. |
| `after_message_id` | string | No | Return messages strictly after this message ID in ascending session_index order. Mutually exclusive with offset. Continue incremental reads using last_message_id from the prior response. |

#### 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 Projects

**Slug:** `CONDUCTOR_LIST_PROJECTS`

List repositories available to the connected account for creating Conductor workspaces.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum projects to return in this page. The provider publishes no maximum. |
| `offset` | integer | No | Zero-based page offset. Pass next_offset from the prior response to continue. |

#### 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 Sessions

**Slug:** `CONDUCTOR_LIST_SESSIONS`

List one page of agent chat sessions in a Conductor workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum sessions in this page; must be at least 1. |
| `offset` | integer | No | Zero-based page offset. Pass next_offset from the prior response to continue. |
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used to construct deep links. |
| `workspace_id` | string | Yes | Workspace whose sessions to list. |

#### 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 Workspaces

**Slug:** `CONDUCTOR_LIST_WORKSPACES`

List one page of workspaces belonging to a Conductor project, including deep links and recent activity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum workspaces in this page; must be at least 1. |
| `offset` | integer | No | Zero-based page offset. Pass next_offset from the prior response to continue. |
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used to construct deep links; omit for the deployment default. |
| `project_id` | string | Yes | Project whose workspaces to list. |

#### 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 |

### Query Transcripts

**Slug:** `CONDUCTOR_QUERY_TRANSCRIPTS`

Run one read-only SQL SELECT against the organization's session_transcripts_view. Results can expose sensitive transcript text across many sessions: select only necessary columns, constrain rows with LIMIT, and use this only for deliberate organization-wide analysis. Conductor limits queries to 5 seconds and responses to 500 rows, so results may be truncated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | One read-only SELECT against session_transcripts_view. Use LIMIT and select only necessary columns because results may contain sensitive organization-wide transcript data. Conductor enforces its SQL allowlist. |

#### 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 |

### Rename Session

**Slug:** `CONDUCTOR_RENAME_SESSION`

Change an existing Conductor session's display name without stopping its agent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | New non-empty session name. |
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used for the returned deep link. |
| `session_id` | string | Yes | Session to rename. |

#### 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 |

### Rename Workspace

**Slug:** `CONDUCTOR_RENAME_WORKSPACE`

Change the display name of an existing Conductor workspace without changing its lifecycle state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | New non-empty workspace name. |
| `channel` | string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev") | No | Desktop channel used for the returned deep link. |
| `workspace_id` | string | Yes | Workspace to rename. |

#### 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 |

### Send Message

**Slug:** `CONDUCTOR_SEND_MESSAGE`

Send a prompt to a Conductor session agent. This can start external agent/model execution and incur charges; it is not a passive transcript append. Call only when the user intends the agent to act.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Non-empty prompt to send. Treat its contents as potentially sensitive. |
| `message_id` | string | No | Optional caller-selected message id for correlation or idempotency where supported; omit to let Conductor generate one. |
| `session_id` | string | Yes | Session agent that should receive and execute the prompt. |

#### 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 |

### Stop Session

**Slug:** `CONDUCTOR_STOP_SESSION`

Cancel only the current turn and queued messages, or archive the entire session. Both can discard queued work; archive also stops the agent and leaves the session read-only. Confirm the intended action before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("cancel_current_turn" | "archive_session") | Yes | cancel_current_turn cancels active and queued messages but keeps the session usable; archive_session stops and archives the session and drops queued messages. |
| `session_id` | string | Yes | Session whose active or queued work should be stopped. |

#### 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 |