Skip to content
Port OS

Upsert Subscription

← HTTP API reference
View source specification ↗
POST /subscriptions

Used to upsert a subscription to an event stream.

Required scope

subscription:write

Request body

Fields

subscriptionSubscription

A subscription is a way to listen to events

Returns

200

OK, this confirms a subscription occurs, this is eventually consistent and is not guarantee

Fields

resultUpsertSubscriptionResult

Errors

400

Invalid request payload

Check the request fields and any validation details, then correct the payload.

500

Internal server error

Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.