create_token

Generate a new API token for MCP/CLI access. Requires Owner role. The plaintext token is returned only at creation time — store it securely. Returns: token_id (str) — UUID of the new token; name (str) — human-readable label; token (str) — full plaintext token shown once only; prefix (str) — first 8 chars for identification without the secret; warning (str) — reminder to store the token securely.

Parameters

Name	Type	Required	Default	Description
name	str	Yes	—

Returns

Returns a structured object. Top-level fields:

• token_id (string)
• name (string)
• token (string)
• prefix (string)
• warning (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "create_token",
  "arguments": {
    "name": "ci-runner"
  }
}

Response

{
  "token_id": "44444444-4444-4444-4444-444444444444",
  "name": "ci-runner",
  "token": "btk_abcd1234efgh5678ijkl9012mnop3456",
  "prefix": "btk_abcd",
  "warning": "Store this token securely. It will not be shown again."
}

Notes

• Module: Admin
• Requires authentication via API token or Auth0 JWT.