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.

​
Project settings

Open Settings → Project → General to edit the active project. Select Save Changes to apply a new Name and Description. Delete Project removes the project once it is empty.

​
Find the project ID

The Project ID row on the project settings page holds the value to copy. GET /v2/projects returns it as project_id, a UUID such as 0192f0a0-8c3e-7b1f-9a6d-2f5c8e1b4d7a. Requests that take project_id accept this value.

​
Create an API key for this project

Keys belong to a project. Create one under API Keys, select this project, and copy the token from the Save your key dialog, which shows it once. Requests send it as Authorization: Bearer <key>.

​
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 the project scope, 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 Filter to narrow the list, or select + Create to add a new entity directly from the directory. The top bar search finds any entity across the workspace.

​
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.