Help Center/ Simple Message Notification/ API Reference (Paris Region)/ APIs/ Topic Operations/ Deleting a Topic
Updated on 2025-01-07 GMT+08:00
View PDF
Share

Deleting a Topic

Description

  • API name

    DeleteTopic

  • Function

    Delete a topic and its subscribers. If a topic is deleted, a pending message will fail to deliver to the topic subscribers.

URI

  • URI format

    DELETE /v2/{project_id}/notifications/topics/{topic_urn}

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

    See Obtaining a Project ID.

    topic_urn

    Yes

    String

    Unique resource ID of a topic. You can obtain it by referring to Querying Topics.

Request

Example request 
DELETE https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/urn:smn:regionId:f96188c7ccaf4ffba0c9aa149ab2bd57:test_topic_v2

Response

  • Parameter description

    Parameter

    Type

    Description

    request_id

    String

    Request ID, which is unique
  • Example response 
    { 
     "request_id": "5fcba32bd2814ea39431829c22bda94b"
}

Returned Value

See Returned Value.

Error Codes

See Error Codes.

Parent topic: Topic Operations