Skip to main content
Projects are the top-level organizational unit in Orq.ai. Each project is a workspace-level container that holds Deployments, Prompts, Agents, Knowledge Bases, and Datasets. Create separate projects to isolate environments, control team access independently, and keep observability data scoped per use case. For example, separate production and staging into distinct projects to scope API keys, permissions, and trace data independently. Projects appear as a project name dropdown in the top bar.

​
Using Projects

Switching projects Click the project name in the top bar to open the project dropdown. Search for a project, select one from the list, or click Create New Project.
Project dropdown in the top bar showing All Projects, Default Project, TestProject, and a Create New Project option

Select or create a Project from the top bar dropdown.

Editing or deleting a project Click the menu next to a project name in the dropdown to Edit the project name or Delete the project.
Project dropdown with the ellipsis menu open on a project row, showing Edit and Delete options

Edit or delete a project from the project dropdown menu.

A project can only be deleted if it’s empty. Remove all entities from the project first.

​
Browsing Projects

Use Directory in the sidebar to view all entities in the current project. The breadcrumb shows which project is active.
Directory view listing all entity types in a flat list with Name, Last Update, and Updated by columns, plus Search, Filter, and Create controls

Directory view showing all entities in the Default Project with last update date and team member.

The directory lists all entity types in a single flat view: Evaluators, Deployments, Knowledge Bases, Experiments, Agents, Playgrounds, and more. Use Search and Filter to narrow the list, or click + Create to add a new entity directly from the directory.

​
Permissions

When creating a project, assign which Teams have access. Each team has members with different access levels across the project entities.
Project creation dialog showing a team selector with access level options

Choose which team to add to a Project.