Create API Key

Create a new API key for your company. Choose its permissions; each must be one the calling key holds and its creator still holds, so a key can never mint a stronger key. Without permissions or accessLevel, the new key gets the view permissions. The key itself appears only in this response, so store it right away; MindCloud keeps only a hash.

POST

Body

Arguments

stringrequired

A name that tells you later what the key is for, up to 256 characters.

array of string

The permissions the new key holds, for example ["workflow:view","log:view"]. Defaults to the view permissions.

string

Instead of permissions: read_only, run_workflows, or full_access, which give that level's permissions. Send one of permissions and accessLevel, not both.

Try this request

API Key

Request

curl --request POST \
  --url 'https://connect.mindcloud.co/v2/api-keys' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": ""
}'

{
  "success": true,
  "data": {
    "id": "apikey_K7dM2qP9xL4s",
    "name": "Reporting",
    "accessLevel": "none",
    "permissions": [
      "log:view",
      "workflow:view"
    ],
    "key": "4f8a1c09b6e2d47a83f5c1e09d2b6a74c3e8f01b5a9d27c4e6f30a18b5d92c7e",
    "createdOn": "2026-07-23T14:05:00.000Z"
  }
}