v62

latestOpenAPI 3.1.0Dual (AGPL3.0, Commercial License Available)raw.githubusercontent.com2026-08-03211303932.5 KB

User API Keys

Update a user API key

put/api/v1/auth/keys/{id}

idstring uuid required

API key ID

expires_atstring date-time nullable

When this record stops being valid.

is_enabledboolean

Whether the key may still be used. Disabled keys are rejected.

keystring required

The stored key. Returned redacted except on creation and rotation.

last_usedstring date-time nullable required

When this key was last used to authenticate.

namestring required

Human-facing name for this key.

network_idsstring[]

Network IDs this key has access to (hydrated from junction table)

organization_idstring uuid required

The organization that owns this record.

permissions'Owner' | 'Admin' | 'Member' | 'Viewer'

tagsstring[] required

Tags assigned to this entity.

user_idstring uuid required

User the key acts on behalf of.

created_atstring date-time required

When this record was first created.

idstring uuid required

Server-assigned unique identifier.

updated_atstring date-time required

When this record was last modified.

API key updated

errorstring nullable

Human-readable failure message. Omitted on success.

successboolean required

true when the request succeeded. false responses carry error instead of data.

{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.7"
  }
}