DELETE
/api/admin/api-keys/{api_key_id}/allowlistAdminRemove a mailing list from an API key's audience mailing-list allowlist
Mailing-list entries and individual-recipient entries form ONE combined audience allowlist for the key (unless the key's allow_any_audience flag is set).
operationId
removeApiKeyAllowlistEntryAdmin: API KeysAuthentication & permissionsAdmin
Platform administrators only
- Accepted credentials
- Access token (Bearer)
Authorization: Bearer <JWT> - Access token (cookie)
cookie "access_token_schemavaults-mail"
- Access token (Bearer)
- Who may call
- Platform administrators only
Path parameters
| Name | Type | Description |
|---|---|---|
| api_key_id* | string (uuid) | ID of the API key. |
Request body
Required
application/json
ApiKeyAllowlistMutationBody
| Property | Type | Description |
|---|---|---|
| mailing_list_id* | string (uuid) | Mailing list to add to / remove from the key's audience. |
JSONExample
"mailing_list_id""123e4567-e89b-12d3-a456-426614174000"
Responses
application/json
SuccessMessageResponseSuccess envelope for operations with no response payload.
| Property | Type | Description |
|---|---|---|
| success* | true | |
| message* | string |
JSONExample
"success"true
"message""string"
Example request
bashcurl
curl -X DELETE 'https://mail.schemavaults.com/api/admin/api-keys/<api_key_id>/allowlist' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: application/json' \
-d '{
"mailing_list_id": "123e4567-e89b-12d3-a456-426614174000"
}'