Regenerates a signature key for a given callback. Regenerating a signature key deactivates the existing key.
| Name | Type | Description |
|---|---|---|
callbackId | string | Required. A unique identifier for the callback. |
| Status | Name | Type | Description |
|---|---|---|---|
| 200 | New signature key generated. Review example response. | ||
| callbackName | string | Name of the callback. | |
| callbackId | string | Unique identifier of the callback. | |
| url | string | HTTPS URL of the customer callback that receives event notifications in the format https://host[/path]. | |
| signatureKey | string | A symmetric key to authenticate messages. |
To regenerate the signature key, send a PUT request to the /platform/v1/ens-regenerate endpoint.
1Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
2PUT /platform/v1/ens-regenerate
3Content-Type: application/json
4Authorization: Bearer YOUR_ACCESS_TOKEN
5
6[{
7 "callbackId": "65b885ab-c2b4-46fe-85d0-d6cb8be8057d"
8}]The response includes information about the callback.
1HTTP/1.1 200 OK
2[{
3 "callbackName": "cb1",
4 "callbackId": "65b885ab-c2b4-46fe-85d0-d6cb8be8057d",
5 "url": "https://example.com/",
6 "signatureKey": "KktBXb9V556KtSDG7Wb5a0xHAu/z9n3k+YekDzLy7i0="
7}]| Response | Reason |
|---|---|
| 200 OK | New signature key generated. Review example response. |
| 400 Bad Request | Unable to process the request. |
| 401 Unauthorized | Request not authorized; missing or incorrect bearer token. |
| 403 Forbidden | Failed to pass authorization. |
| 404 Not Found | Callback ID doesn’t exist for this MID. |
| 500 Server Error | Internal error |
j