Projects

Overview

Projects are isolated workspaces for your datasets, prompts, traces, and evaluations. With the Admin SDK you can create, update, and delete projects programmatically. This supports project-per-agent, project-per-environment, and project-per-customer organization models.

List Projects

You can list every project in your organization.

1
from confidentai import ConfidentAI
2
3
client = ConfidentAI()
4
5
projects = client.projects.list()
6
for project in projects:
7
    print(project.id, project.name)

Create a Project

You can create a new project with just a name, while the description is optional. Creating a project also generates its first project API key, so the call returns both the project and that api_key (whose full secret is only available here).

1
created = client.projects.create(
2
    name="Customer Support Bot",
3
    description="Production support assistant",
4
)
5
print(created.project.id)  # e.g. "clq9z3x1k0001la08f7t3g5p2"
6
print(created.api_key.value)  # e.g. "confident_us_proj_...", shown only once

Get a Project

You can retrieve a single project by its project_id.

1
project = client.project("clq9z3x1k0001la08f7t3g5p2")
2
project.get()

Update a Project

You can update a project’s name, description, or both, and only the fields you pass are changed.

1
project = client.project("clq9z3x1k0001la08f7t3g5p2")
2
project.update(name="Support Bot (v2)")

Delete a Project

You can permanently delete a project from your organization.

1
project = client.project("clq9z3x1k0001la08f7t3g5p2")
2
project.delete()

Next Steps

After projects are configured, manage access and keys: