Add a New Subscription Topic

Use this endpoint to add a new subscription topic to the subscription service.

Upon creation, the listed subscriber will be granted owner permissions to the created topic.

URL

https://{{HOST}}/subscriptiontopic

Method

POST

Required IMS Scopes

  • subscription_write
  • apollo_write

Request Header Parameters

Type Value Description
Authorization
required		 Bearer {access_token} IMS access token
Content-Type
required		 application/json Content Type

Request Body Params

Property Description Type
id Identifier for Topic string

Example

Request

curl -X POST 
  'https://{{HOST}}/subscriptiontopic' 
  -H 'Content-Type: application/json' 
  -d '
    {
        "id": "d8178fd0-35ed-499e-89ad-d5b13f0d4427"
    }
'

Response

{
    "id": "d8178fd0-35ed-499e-89ad-d5b13f0d4427"
}

Errors

Error Description
401 Unauthorized
403 Forbiden. Possible causes:
* You do not have access to this endpoint (scope)
409 Subscriber is already registered to this topic
504 Timeout while attempting to write topic to storage repository

Response Body Parameters

Name Description Schema
id For the topic object string