POST
/api/admin/api-keys/{api_key_id}/sendersAdminAdd a sender to an API key's allowed-senders scope
With zero entries the sender dimension is unrestricted; otherwise the send's from (after default fallback) and replyTo must each match an entry (exact address or *@domain wildcard).
operationId
addApiKeySenderAdmin: 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
ApiKeySenderMutationBody
| Property | Type | Description |
|---|---|---|
| sender* | string | A lowercase email address, or a |
JSONExample
"sender""*@example.com"
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 POST 'https://mail.schemavaults.com/api/admin/api-keys/<api_key_id>/senders' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: application/json' \
-d '{
"sender": "*@example.com"
}'