> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conductor

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

![Conductor logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/conductor.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=26f229e544c418069e7999d15401cbf5)

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

## Tools

> [accordion] 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
>
> **action** `string ("sleep" | "archive")` *required*
>
> sleep pauses the workspace; archive stops and archives it. Both operations are documented as idempotent.
>
> **workspace\_id** `string` *required*
>
> Workspace whose lifecycle state to change.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **name** `string`
>
> Optional session name.
>
> **agent** `string ("claude" | "codex" | "cursor" | "acp")` *required*
>
> Agent implementation for this session.
>
> **model** `string`
>
> Documented model id compatible with the selected agent.
>
> **effort** `string ("none" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra")`
>
> Reasoning effort supported by the selected agent and model.
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used for the returned deep link; omit for the deployment default.
>
> **fast\_mode** `boolean`
>
> Enable fast mode when supported by the selected agent and model.
>
> **session\_id** `string`
>
> Optional caller-selected session id; omit to let Conductor generate one.
>
> **workspace\_id** `string` *required*
>
> Workspace in which to create the session.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **env** `object`
>
> Environment variables for the workspace. Treat values as sensitive and include only values the user intends to expose to that workspace.
>
> **name** `string`
>
> Optional non-empty workspace name.
>
> **agent** `string ("claude" | "codex" | "cursor" | "acp")`
>
> Agent for the first session; model and effort must be compatible with it.
>
> **model** `string`
>
> Documented Conductor model id compatible with the selected agent.
>
> **branch** `string`
>
> Repository branch to check out; omit for the repository default.
>
> **effort** `string ("none" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra")`
>
> Reasoning effort supported by the selected agent and model.
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel for the returned deep link; omit for the deployment default.
>
> **project\_id** `string`
>
> Existing Conductor project id. Provide exactly one of project\_id or repository\_url.
>
> **session\_name** `string`
>
> Optional non-empty name for the automatically created first session.
>
> **repository\_url** `string`
>
> Git repository URL. Provide exactly one of repository\_url or project\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **message\_id** `string` *required*
>
> Transcript message id to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project
>
> **Slug:** `CONDUCTOR_GET_PROJECT`
>
> Get one Conductor project and its repository remote by project id.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> Project id returned by List Projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used for the session deep link; omit for the deployment default.
>
> **session\_id** `string` *required*
>
> Session to inspect.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used for the workspace deep link; omit for the deployment default.
>
> **workspace\_id** `string` *required*
>
> Workspace id to inspect.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **limit** `integer`
>
> Maximum messages in this page; must be at least 1.
>
> **offset** `integer`
>
> 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` *required*
>
> Session whose potentially sensitive transcript messages to read.
>
> **after\_message\_id** `string`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Projects
>
> **Slug:** `CONDUCTOR_LIST_PROJECTS`
>
> List one page of Conductor projects and their repository remotes available to the connected account for creating workspaces.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum projects to return in this page. The provider publishes no maximum.
>
> **offset** `integer`
>
> Zero-based page offset. Pass next\_offset from the prior response to continue.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sessions
>
> **Slug:** `CONDUCTOR_LIST_SESSIONS`
>
> List one page of agent chat sessions in a Conductor workspace.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum sessions in this page; must be at least 1.
>
> **offset** `integer`
>
> Zero-based page offset. Pass next\_offset from the prior response to continue.
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used to construct deep links.
>
> **workspace\_id** `string` *required*
>
> Workspace whose sessions to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspaces
>
> **Slug:** `CONDUCTOR_LIST_WORKSPACES`
>
> List one page of workspaces belonging to a Conductor project, including deep links and recent activity.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum workspaces in this page; must be at least 1.
>
> **offset** `integer`
>
> Zero-based page offset. Pass next\_offset from the prior response to continue.
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used to construct deep links; omit for the deployment default.
>
> **project\_id** `string` *required*
>
> Project whose workspaces to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **query** `string` *required*
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Rename Session
>
> **Slug:** `CONDUCTOR_RENAME_SESSION`
>
> Change an existing Conductor session's display name without stopping its agent.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New non-empty session name.
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used for the returned deep link.
>
> **session\_id** `string` *required*
>
> Session to rename.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Rename Workspace
>
> **Slug:** `CONDUCTOR_RENAME_WORKSPACE`
>
> Change the display name of an existing Conductor workspace without changing its lifecycle state.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New non-empty workspace name.
>
> **channel** `string ("prod" | "alpha" | "alpha-chromium" | "beta" | "patch" | "dev")`
>
> Desktop channel used for the returned deep link.
>
> **workspace\_id** `string` *required*
>
> Workspace to rename.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **message** `string` *required*
>
> Non-empty prompt to send. Treat its contents as potentially sensitive.
>
> **message\_id** `string`
>
> Optional caller-selected message id for correlation or idempotency where supported; omit to let Conductor generate one.
>
> **session\_id** `string` *required*
>
> Session agent that should receive and execute the prompt.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **action** `string ("cancel_current_turn" | "archive_session")` *required*
>
> 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` *required*
>
> Session whose active or queued work should be stopped.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
