Create API key

Mints a key and returns it in full, once. raw is never retrievable again, so store it when you receive it. A key authenticated with an API key cannot grant scopes it does not itself hold.

POST/api-keys

AuthAPI keyorOAuth tokenHow to send it

Request body

namestring: ≥ 1 characters≤ 256 characters
scopesstring[]: default ["generate"]≥ 1 items

Response

API key created

dataobjectrequired

Errors

A failed call names what went wrong in code, with a sentence in message. The codes, which of them are worth retrying, and how to read a validation failure are on Errors.

Request

curl -X POST https://api.mynth.io/api-keys \
  -H "Authorization: Bearer $MYNTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

{
  "data": {
    "raw": "string",
    "api_key": {
      "id": "string",
      "name": "string",
      "key_preview": "string",
      "user_id": "string",
      "scopes": [
        "generate"
      ],
      "spending_limit": "string",
      "spending_limit_period": "day",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}