Skip to content

Workspace controls

A RunAgents workspace is the operational boundary for agents, tools, identities, runs, and approvals.

Workspace-scoped controls

Current docs show workspace scoping in several places:

  • CLI and SDK configuration target a specific workspace endpoint and namespace.
  • Agents, tools, model providers, and approvals are managed within that workspace.
  • Identity providers are configured for the workspace so incoming requests can be validated and attributed.
  • Run history and approval state stay attached to the workspace that executed them.

What teams usually control per workspace

  • platform endpoint and API key
  • namespace used for API scoping
  • identity providers
  • registered tools and model providers
  • deployed agents and drafts
  • runtime approvals and audit history