Admin SDK Quickstart

Install the Admin SDK and make your first management call.

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.

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.

Install the confident-client Agent Skill with any Skills-compatible installer. This works with Cursor, Claude Code, Codex, Windsurf, OpenCode, and any other assistant that supports the Skills standard:

npx skills add confident-ai/confident-client --skill "confident-client"

The skill teaches your agent how to drive the Admin SDK — creating projects, inviting members, composing roles from policies and permissions, assigning governance policies, and provisioning API keys. It triggers automatically on prompts like the ones below.

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

pip install confidentai

npm 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

from confidentai import ConfidentAI

client = ConfidentAI()

import { ConfidentAI } from "confidentai";

const client = new 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.

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

const client = new ConfidentAI({ apiKey: "confident_us_org_..." });

Make your first call

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

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

// List the projects in your organization
const projects = await client.projects.list();
projects.forEach((project) => console.log(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.

Setting this up for your organization?Set up the controls your team needs before a wider rolloutTalk to us

Last updated on July 27, 2026