Admin SDK Quickstart | Confident AI Docs

Overview

The Admin SDK lets you manage organizations, projects, members, roles, and API keys programmatically. It is available for both Python and TypeScript through the confidentai SDK.

This quickstart shows how to install the SDK, configure an Organization API Key, create a client, and list projects in your organization.

Vibe Code Your Administration

Let your coding agent run your account administration for you — creating projects, inviting members, composing roles from policies and permissions, and provisioning API keys. Describe what you want in plain English and the agent writes and runs the correct Admin SDK calls. For the full walkthrough, see the Vibe Code Your Administration guide — or choose the install method for your agent below to get started right away.

Claude Code (plugin)

Cursor, Codex, Windsurf & others (Skills CLI)

Run these four commands in Claude Code:

$ /plugin marketplace add confident-ai/confident-client
$ /plugin install confident-client@confident-ai-plugins
$ /reload-plugins
$ /plugins

The /plugins command should list confident-client under your installed plugins.

Once installed, open your project and tell your agent what you need. Example prompts:

“Create a Confident AI project called ‘Customer Support Bot’ and make alice@example.com the owner.”
“Invite alice@example.com and bob@example.com to my organization as analysts.”
“Create an ‘Analyst’ role with read-only access and assign it to bob@example.com.”

Your agent will confirm the SDK language, run the calls in the right order (permissions → policies → roles), and hand back the IDs and one-time API keys it creates.

Get Started

Install the SDK

Python

TypeScript

$ pip install confidentai

Set your Organization API Key

The ConfidentAI client requires an Organization API Key, which is separate from the project keys used for tracing and evaluations. Retrieve yours before configuring the client.

The client reads the CONFIDENT_ORG_API_KEY environment variable by default. This is separate from the CONFIDENT_API_KEY used for tracing and evaluations, so you can configure both at once.

$ export CONFIDENT_ORG_API_KEY="confident_us_org_..."

Create a client

Python

TypeScript

1 from confidentai import ConfidentAI
2 
3 client = ConfidentAI()

You can also pass the key explicitly instead of relying on the environment variable. This is useful when managing multiple organizations from the same process.

Python

TypeScript

1 client = ConfidentAI(api_key="confident_us_org_...")

Make your first call

List the projects in your organization to verify that the client is configured correctly.

Python

TypeScript

1 # List the projects in your organization
2 for project in client.projects.list():
3     print(project.id, project.name)

Done ✅. The Admin SDK client is configured and can make management requests.

Next Steps

Review the resource references for common management operations:

Projects

Create, update, and delete projects.

Members & Invitations

Manage organization and project membership.

Roles, Policies & Permissions

Manage roles, policies, and permissions.

API Keys

Automate key provisioning and rotation.