Omni Developers

Workspaces

Discover the persistent Omni workspaces available to the authenticated user.

A workspace is the public boundary for an ongoing Omni experience: its persona or companion, persistent messages, and Vault knowledge.

GET/v1/workspaces Preview
workspace:read
curl -sS "$OMNI_API_ORIGIN/v1/workspaces" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Each item in data.workspaces exposes only public fields such as id, name, kind, created_at, and updated_at. Use the returned id with tasks, history, and Vault routes.

Developer Preview does not expose workspace creation, deletion, persona management, or conversation CRUD. Create and configure workspaces in Omni, then discover them through the API.

Requests for inaccessible resources return a safe 404 not_found rather than revealing whether another user's resource exists.