AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Conductor List Workspaces
Lists Conductor workspaces with optional project, state, name, repository, creator and activity filters. Requires your own Conductor API key, created at app.conductor.build/users/api-keys and added through AutoGPT’s credentials UI. Select that credential for each Conductor block; no server-wide default key is used.
Conductor List Workspaces
What it is
List Conductor workspaces, optionally filtered by project, state, name, repository, creator or activity date. When filtering within a project, a page can be empty while has_more is true; continue with next_offset until has_more is false.
How it works
Without project_id the block calls GET /v0/workspaces and passes every filter as query parameters (state may repeat). With project_id it calls GET /v0/projects/{id}/workspaces, which only paginates, so the block applies the same filters itself to each returned page: exact state and creator, case-insensitive name and repo substrings, since against lastActivityAt, and archived workspaces hidden unless include_archived is set or archived is among the requested states. A filtered page can therefore be empty while has_more is still true; keep paging with next_offset, which always advances by the raw page size. since must be an ISO-8601 date or timestamp and is validated before any request. Each workspace is also emitted one at a time on workspace for fan-out.
Inputs
| Input | Description | Type | Required |
|---|---|---|---|
| project_id | Only workspaces of this project (repository). Leave empty for all projects. | str | No |
| state | Only workspaces in these states, e.g. ready, sleeping | List["initializing" | "ready" | "sleeping" | "archived" | "deleted" | "updating" | "unstarted"] | No |
| name | Filter by workspace name | str | No |
| repo | Filter by repository URL | str | No |
| creator | Filter by creator user ID | str | No |
| since | Only workspaces whose last activity is on or after this ISO-8601 date or timestamp | str | No |
| include_archived | Include archived workspaces | bool | No |
| limit | Maximum number of workspaces | int | No |
| offset | Pagination offset | int | No |
Outputs
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| workspaces | Workspaces: id, projectId, name, state, repoUrl, deepLink, creatorName, lastActivityAt | List[Dict[str, Any]] |
| workspace | Each workspace, one at a time | Dict[str, Any] |
| has_more | Whether more pages exist | bool |
| next_offset | Offset to request the next page; with project_id a page can be filtered down to nothing while has_more is still true | int |
Possible use case
Find work in progress: Filter state to ready to see which workspaces have a live sandbox before sending prompts.
Clean-up sweep: List sleeping workspaces older than a since date and feed each workspace into Manage Workspace to archive it.