Add one or more subscriptions to a workspace.
NOTE: You need to have the edit permission for the Devices and Subscription service to invoke this API.
This API provides an asynchronous response and will always return 202 Accepted
if basic input validations are successful. The location header in the response provides the URI to be invoked for fetching progress of the subscription addition task. For details about the status fetch URL, refer to the API Get progress or status of async operations in subscriptions.
Rate limits are enforced on this API. Four requests per minute is supported per workspace, and the API returns a 429
status code if this threshold is breached.
Maximum five subscriptions per request.
required | Array of objects (RequestPostSubscription) An array of subscription keys. |
Request accepted
Bad request
Unauthorized request
The operation is forbidden
Validation error
Too many requests
Internal server error
{- "subscriptions": [
- {
- "key": "string",
- "tags": {
- "property1": "string",
- "property2": "string"
}
}
]
}
{- "code": 0,
- "status": "100 CONTINUE",
- "transactionId": "string"
}