workspaces list

[!NOTE] Requires the airbyte-agent CLI on PATH. Install via brew install airbytehq/tap/airbyte-agent or see the project README.

List workspaces in the organization. Workspace names are the identifier passed to almost every connector command, so this is typically the second command in a session (after airbyte-agent enroll).

[!IMPORTANT] Always pass parameters as --json '{...}' (use --json '{}' for an unfiltered list). Agents should not use per-parameter flags.

[!IMPORTANT] If only one workspace exists, use it directly without prompting the user. Most accounts have a single workspace.

[!NOTE] Pagination is automatic — all workspaces are returned in a single response regardless of server-side page size.

Usage