Update event subscription

PUT

/subscriptions/{id}

Last modified:2026-09-27 19:31:00

OperationId:UpdateSubscription

Changes where a subscription sends, what it sends, or how long it lives. Send only the fields to change.

Requires Basic User, Site Manager, Office Manager, Reseller, or Super User.

Who can change or delete a subscription:

Super User: any subscription

Reseller: one for a domain in its own territory, never a platform-wide one or one a Super User created

Office Manager: any in its own domain

Site Manager: its own, or one for a user of its own site, never a domain-wide one

Every other scope: its own

Anything else returns 403, and the message names the reason.

You can change post-url, model, subscription-expires-datetime, subscription-geo-support, and preferred-server. A new post-url follows the create rules. A new model must be a known model (400) that you can read (403). Send error-count or posts-count as 0 to reset it; any other value is ignored. domain, user, and reseller cannot change: a different value returns 400, so delete the subscription and create a new one. Leaving out subscription-expires-datetime keeps the current expiry. subscription-expires-datetime takes RFC 3339, such as 2027-09-01T14:30:00+00:00, or YYYY-MM-DD HH:MM:SS in UTC. It is stored in UTC and read back as RFC 3339. Any other value returns 400.

A 202 means the change was saved on this server and published to the others over the service bus (SBUS), including a switch of subscription-geo-support from yes to no. Delivery picks it up within about 5 seconds.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The change was saved and published.

Bodyapplication/json

🟠404

🟠400

🟠401

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Move and renewReset counters

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/subscriptions/9f86d081884c7d659a2feaa0c55ad015' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "post-url": "https://core1.example.com/event2",
    "error-count": 0,
    "posts-count": 0
}'

Response Example

202 - Accepted

The change was saved and published.

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-09-27 19:31:00

Create event subscription

Update domain event subscription