API Keys

Create key

Changed on

Creates a new API key with an optional expiry. The full key value is only returned once in the response.

post/v1/api-keys

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/api-keys
  • Auth: HTTP bearer

Request body

namestring required
expiresIninteger

Days until expiry

scope'full' | 'profiles'

'full' grants access to all profiles (default), 'profiles' restricts to specific profiles

profileIdsstring[]

Profile IDs this key can access. Required when scope is 'profiles'.

permission'read-write' | 'read'

'read-write' allows all operations (default), 'read' restricts to GET requests only

disabledResourceGroupsstring[]

Resource groups to DISABLE on this key (opt-out denylist). Omit for a legacy full-access key. A key with any group disabled mints with the zrk_ prefix, gets 403 with code=insufficient_permissions and required_group on operations in disabled groups (each operation's group is published as x-resource-group), and can never manage API keys, invites, or member identity. With 'messages' disabled, the key cannot read or send direct messages through any API surface and cannot create or edit a webhook subscription broader than itself. Subscriptions that already exist are governed by their own disabledResourceGroups, not by this key's. OAuth connector tokens resolve against the same registry, but their groups are not settable yet.

Response

Created

messagestring

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status