Create a Data Feeds subscription

Receive every deliverable dataset in the named places, optionally only some topics, plus datasets named directly. Datasets that join later each send feed.dataset.added. The subscription belongs to the workspace.

post/v1/subscriptions

Request

  • Base URL: https://api.ploti.ai
  • URL: https://api.ploti.ai/v1/subscriptions
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique value, such as a UUID. A retry with the same key within a day returns the first answer instead of creating again; the same key with a different body is refused as idempotency_conflict.

Request body

namestring
placesstring[]

Place ids from list_feed_places. Every deliverable dataset in each place.

topicsstring[]

Only these topics within places, by the ids list_feed_topics gives. Every topic when left out.

datasetIdsstring[]

Datasets to include on their own, from any place in the coverage.

Response

Created

idstring required
namestring required
placesstring[] required
topicsstring[] required
datasetIdsstring[] required
revisioninteger required

Send it back as If-Match (or revision) to update.

datasetCountinteger required
lastEventCursorstring nullable required
createdAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.