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
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
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.
Last updated
Was this helpful?