Skip to main content
Use registry__list_workspaces before your first create to find the workspace_id the write should target.
  • Optional inputs: limit, session_id, and Gateway’s rationale.
  • Filters: the same list filters as GET /registry/v1/workspaces, with the same meanings.
  • Archived workspaces: the workspace_status filter decides whether they appear. Without it the tool lists active workspaces only, that route’s default.
  • Limit: defaults to 50 and accepts at most 500.
  • Returns: the caller’s discoverable workspaces: ones the caller holds a role in, plus open-to-organization workspaces they have not joined.
  • Effect: read only.
If the result contains more than one workspace, select one explicitly. Do not guess where an artifact should be created.