---
title: "Mint an operator token (raw token returned once)"
method: POST
path: "/operator-tokens"
tags: ["Setup · Operator tokens"]
---

# Mint an operator token (raw token returned once)

`POST /operator-tokens`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/operator-tokens`
- Auth: HTTP bearer

## Request body

- MintOperatorTokenDto
  - `label` string: Human label shown in the key list. Not used for auth.
  - `scopes` string[], required: Scopes the key may exercise. Ask for a named preset from GET /operator-tokens/scopes rather than transcribing this list.
  - `ttlSec` number: Lifetime in seconds. Omitted means the service default; short is the norm.

## Response `201`

Created

- OperatorTokenMintResponseSchema
  - `keyId` string, required
  - `token` string, required
  - `scopes` string[], required

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)