Set up hierarchy

This page describes setting up and managing your LangSmith organization and workspaces:

• Set up an organization: Create and manage organizations for team collaboration, including user management and role assignments.
• Set up a workspace: Set up and configure workspaces to organize your LangSmith resources, manage workspace members, and configure settings for team collaboration.
• Set up agents and applications: Group resources within a workspace to further organize them, and take advantage of ABAC permissioning.

​

Set up an organization

​

Create an organization

When you log into the UI for the first time, LangSmith will create a personal organization for you automatically. If you’d like to collaborate with others, you can create a separate organization and invite your team members to join.

1. Open the Organizations drawer by clicking your profile icon in the bottom left
2. Select the organization profile dropdown at the top of the menu.
3. Click + Create organization.

Shared organizations require a credit card before you can use them. You will need to set up billing to proceed.

​

Manage and navigate workspaces

Once you’ve subscribed to a plan that allows for multiple users per organization, you can set up workspaces to collaborate more effectively and isolate LangSmith resources between different groups of users. To navigate between workspaces and access the resources within each workspace (trace projects, annotation queues, etc.), select the desired workspace from the picker in the bottom left of the LangSmith UI.

​

Manage users

Manage membership in your shared organization in the Members and roles tabs on the Settings page. Here you can:

• Invite new users to your organization, selecting workspace membership and (if RBAC is enabled) workspace role.
• Edit a user’s organization role.
• Remove users from your organization.

Organizations on the Enterprise plan may set up custom workspace roles in the Roles tab. For more details, refer to the access control setup guide.

​

Organization roles

Organization-scoped roles are used to determine access to organization settings. The role selected also has an impact on workspace membership:

• Organization Admin grants full access to manage all organization configuration, users, billing, and workspaces. Any Organization Admin has Admin access to all workspaces in an organization.
• Organization User may read organization information, but cannot execute any write actions at the organization level. You can add an Organization User to a subset of workspaces and assigned workspace roles as usual (if RBAC is enabled), which specify permissions at the workspace level.

For a full list of permissions associated with each role, refer to the Administration overview page.

​

Set up a workspace

When you log in for the first time, LangSmith will create a default workspace for you in your personal organization. You can use workspaces to separate resources between different teams or business units to establish clear trust boundaries between them. Within each workspace, Role-Based Access Control (RBAC) manages permissions and access levels, which ensures that users only have access to the resources and settings necessary for their role. Most LangSmith activity happens in the context of a workspace, each of which has its own settings and access controls. For guidance on choosing the right workspace organization model for your team (single workspace per team or multiple teams per workspace), refer to Workload isolation. For what changes when a workspace moves from tracing projects to agents and environments, refer to How agent-based workspaces differ.

​

Create a workspace

To create a new workspace, navigate to the Settings page Workspaces tab in your shared organization and click Add Workspace. Once you have created your workspace, you can manage its members and other configuration by selecting the workspace on the Settings page.

​

Manage users

For users that are already members of an organization, a workspace admin may add them to a workspace in the Workspace members tab on the Workspaces settings page. Users may also be invited directly to one or more workspaces when they are invited to an organization.

​

Configure workspace settings

Workspace configuration exists in the Workspaces settings page tab. Select the workspace to configure and then the desired configuration sub-tab. Configuration options include:

• Workspace members
• API keys
• Secrets
• Feedback config
• Models
• Rules
• Shared URLs

​

Delete a workspace

You can delete a workspace through the LangSmith UI or via API. You must be a workspace admin in order to delete a workspace. In the LangSmith UI:

1. Navigate to Settings.
2. Select the workspace you want to delete.
3. Click the delete icon in the top-right corner of the screen.

​

Set up agents and applications

Within a workspace you can group resources, such as tracing projects and datasets, one level further. A workspace may have zero or more of these groups. What the group is called depends on which information architecture your workspace uses, and the control at the top left tells you which one you are on. An agent-based workspace calls it an agent and selects it from the agent picker in the top bar. A project-based workspace calls it an application and selects it from the Application picker in the sidebar. To view every resource in the workspace rather than one group’s, select All agents in the agent picker, or All applications in the application picker. You may tag resources to multiple applications by adding them to the Application tag under Resource Tags on the Settings page.

---