Subscribe to a topic

post

https://api2.pennsieve.io/notification/topic/{topicId}/subscription

Subscribes the authenticated user to the given topic. The request
body is the subscription's context and is validated before it is
stored: it must be a JSON object matching the topic's context JSON
Schema, and any dataset it references (organizationId + datasetId)
must exist. An empty body is treated as {}. Calling this again with
the same context returns that subscription rather than creating a
duplicate, re-enabling it if the caller had disabled it.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200Caller was already subscribed to this topic with this context; the existing subscription is returned (and re-enabled if it was disabled) rather than creating a duplicate row.

201New subscription created

400Invalid topicId, malformed base64 body, body is not a JSON object, body does not match the topic's context schema, or the referenced dataset does not exist

401Missing or invalid bearer token

404Topic does not exist

409Topic is disabled and accepts no new subscriptions

5XXUnexpected error