Skip to main content
An Organization is the top-level administrative boundary in GroundForge. It contains Workspaces and defines where membership, high-level administration, and shared access are managed. Use a separate Organization when resources and administrators need to be kept fully apart from one another. Day-to-day Agent and Channel work happens inside a Workspace, not directly at Organization scope, so most people will spend very little time here once it’s set up.

​
Organization settings

An Organization record includes an identifier, display name, status, description, and metadata. Organization administrators can create Workspaces and manage access that applies across the whole Organization.

​
Scope matters

Always confirm the selected Organization before creating a Workspace, assigning an Organization-wide role, or issuing a credential. The active Organization is part of the request scope used by both the web application and the CLI, so getting it right up front avoids resources ending up in the wrong place.

​
CLI examples

Use dry run to preview a create or update payload before you change any administration resource. Next: Workspaces. Related: Organizations and Workspaces.
Last modified on July 27, 2026

Related topics

Organizations and WorkspacesOnboarding Create OrganizationResource ModelLangChain Agent Example