Actions138
- API Key Actions
- Automation Rule Actions
- Call Actions
- Catalog Actions
- Channel Actions
- Chat Actions
- Contact Actions
- Group Actions
- Label Actions
- Media Actions
- Message Actions
- Observability Actions
- Presence Actions
- Profile Actions
- Session Actions
- Status Actions
- System Actions
- Template Actions
- Webhook Actions
API Key → Update
AI-generatedSummary
Updates an existing OpenWA API key by ID. Only fields you add to the Fields collection are changed; omitted fields retain their stored values.
Inputs
- API Key Name or ID (required) — Select the API key or provide its ID. This is the key's ID, not its secret.
- Fields — Optional fields to change: Name, Role, Allowed Chats, Allowed IPs, Allowed Sessions, and Expires At. A blank Name is rejected. Lists accept comma-separated text, a JSON array, or an expression resolving to an array; blank lists are omitted and do not clear an existing restriction. Allowed Sessions requires session UUIDs, not session names. Allowed Chats restrictions require OpenWA 0.23.6 or later and make the key unusable on routes that are not chat-aware.
Output shape
A single item containing the API response for the updated key.
The request uses the existing node credential, which must be an admin key. Restrictions are partial updates: only fields set are sent, and empty lists do not clear existing whitelists.