Introduction to the Admin SDK
Programmatically manage your organization, projects, teams, and access control.
Overview
The Admin SDK is the Confident AI API in Python and TypeScript, covering 275 operations across 35 resources. It reaches two kinds of resource:
- Account resources are organization-wide: the organization itself, projects, members and invitations, roles, policies, permissions, governance policies, and API keys.
- Project resources live inside a single project: prompts, datasets, traces, spans, threads, metrics, test runs, evaluations, dashboards, annotation queues, and red teaming.
Use the Admin SDK when work needs to run programmatically instead of through the platform UI. Common use cases include project provisioning, member onboarding, role synchronization, API key rotation, pulling a prompt at runtime, and pushing goldens to a dataset from a pipeline.
Organization vs Project Scope
Every operation is scoped to either the organization or a single project, and the resource decides which API key it needs. One client can hold both keys and picks the right one for each call.
| Scope | Environment variable | Reaches |
|---|---|---|
| Organization | CONFIDENT_ORG_API_KEY | client.organization, client.projects, client.project(id) |
| Project | CONFIDENT_PROJ_API_KEY | every other resource |
Learn how to retrieve each key in Authentication.
client = ConfidentAI() # reads both environment variables
client.organization.get() # organization key
client.datasets.list() # project keyKey Capabilities
Organization
Read and rename the organization tied to your API key.
Projects
Create, read, update, and delete projects in your organization.
Members & Invitations
Invite members, manage memberships, and assign roles.
Roles, Policies & Permissions
Define RBAC with roles, policies, and permissions.
API Keys
Provision, rotate, disable, and delete organization- and project-scoped API keys.
Governance Policies
Create compliance policies and assign them to projects.
Last updated on