Every People API request except the raw OpenAPI document requires a workspace token:

​
Create a token

  1. Go to Settings → APIs & Webhooks
  2. Click + Create key
  3. Save the key and copy it immediately — it is shown once
  4. Use the generated token as your Bearer credential in the playground or your client
For production use, assign the API key to a role under Settings → Members → Roles → Assignment so the key only gets the permissions it needs.
Keep this token secret. Anyone who has it can call the People API with your workspace permissions.

​
Using the playground

On any endpoint page in this API Reference:
  1. Open the interactive playground (right panel or Try it)
  2. Set Authorization to your Bearer token
  3. Fill required parameters
  4. Click Send
Requests are proxied through Mintlify to your API host so you can try calls without leaving the docs.

​
Public OpenAPI document

The OpenAPI document itself is public (no auth):
All other People API endpoints require Authorization: Bearer ....