Skip to main content

Obtaining an API Key

App: Minotaur Sales API
Published by: Minotaur Sales
Supported on: app.minotaursales.io

API keys are managed from your Minotaur account. You can generate a key directly from the app or via the API.

Generate from the App​

The simplest way to create an API key is directly from the Minotaur app:

  1. Log in to app.minotaursales.io.
  2. Go to Settings → Connections → API Key.
  3. Click Generate.
  4. Enter a name and select an expiration period (7, 30, 90, or 365 days).
  5. Select the permissions the key needs.
  6. Click Confirm. Copy the key — it is shown only once.

Keys generated from the app behave identically to keys created via the API.

Generate via API​

The endpoints below require a session token (Bearer <session_token>).

Create a Key​

POST /api/api-key/generate
Authorization: Bearer <session_token>
Content-Type: application/json
{
  "name": "My Integration",
  "expiration": 30
}

Accepted values for expiration: 7, 30, 90, 365.

List Keys​

GET /api/api-key
Authorization: Bearer <session_token>

Returns key records, never the raw key value.

Update or Rotate a Key​

PATCH /api/api-key/update/:id
Authorization: Bearer <session_token>
Content-Type: application/json

This operation can update name and/or expiration, and it issues a new key. The previous key stops working immediately.

Revoke a Key​

PATCH /api/api-key/revoke/:id
Authorization: Bearer <session_token>

Revocation is permanent and cannot be undone.

Important Notes​

  • Key values are shown only once after generate/rotate.
  • Save keys in a secure secret manager.
  • Rotate keys to change permissions.