Introduction

The Minikai API gives your systems programmatic access to a workspace and the information that describes a person’s history and the support around them. This guide takes you from an API key to your first request.

1. Create an API key

In the Minikai app, open Workspace Admin → Security & access and create a key. Copy it once and store it securely. Each key is scoped to a single workspace, and you can rotate or revoke it from the same screen.

2. Base URL and authentication

All requests go to:

https://api.minikai.com/minikai-public

Authenticate by sending your key as a bearer token. For example, listing records:

$
curl https://api.minikai.com/minikai-public/api/v1/Records \
>
  -H "Authorization: Bearer sk_live_..."

See Authentication for key scoping and rotation.

3. Use a typed SDK

You can call the API over raw HTTP, or use a generated SDK that gives you typed requests and responses in your language. Install the one you need:

$
pip install minikai

Then create a client with your key:

1
from minikai import Minikai
2
3
client = Minikai(token="YOUR_API_KEY")

The SDKs section covers both clients in more detail.

Next steps