Skip to main content

API Keys

API keys are workspace-scoped credentials for machine-to-machine access to the IOTMER REST API. Use them in your backend services instead of user JWT tokens.

Create an API key​

  1. Go to Workspace Settings → API Keys
  2. Click New API Key
  3. Enter a descriptive name (e.g. backend-service, ci-pipeline)
  4. Click Create

Create API key

Copy the key now

The full key value is shown only once at creation. Copy and store it securely (e.g. in your secret manager). IOTMER stores only a hashed version.

Using an API key​

Include the key in the X-API-Key header:

GET /workspaces/{id}/devices
X-API-Key: iotmer_ak_xxxxxxxxxxxxxxxxxxxxxxxx

Rotate / revoke a key​

To rotate: create a new key, update your service, then delete the old key.

To revoke immediately: click Delete next to the key in Workspace Settings → API Keys. Deletion is instant and permanent.

API​