Skip to content

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.

3.1 KB
Raw Blame

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.