Update Topic

This endpoint updates the existing topic with the specified ID.

PUT /v1/topics/{topicId}

curl

curl -X PUT https://qstash.upstash.io/v1/topics/:topicId\
  -H "Authorization: Bearer <token>" \
  -d '{ "name": "test2" }'

200

{
  "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJB",
  "name": "test2",
  "endpoints": [
    {
      "endpointId": "ept_6j7BNZus3ZyPy6P7QtLUMCC3Rq7h",
      "url": "https://www.upstash.com",
      "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJA"
    }
  ]
}

Request

topicId · required

The id or name of the topic

name · string · required

The new name of the topic Must only contain alphanumeric characters, underscores, dashes and periods. regex: ^[a-zA-Z0-9-_.]+$

Response

endpoints · Array<Endpoint> · required

Show Endpoint

endpointId · string · required

The id of the endpoint.

topicId · string · required

The id of the topic this endpoint subscribes to.

url · string · required

The url where all requests will be sent to.

name · string · required

A user given name must only contain alphanumeric, hyphen, underscore and periods.

topicId · string · required

Id for this topic

curl

curl -X PUT https://qstash.upstash.io/v1/topics/:topicId\
  -H "Authorization: Bearer <token>" \
  -d '{ "name": "test2" }'

200

{
  "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJB",
  "name": "test2",
  "endpoints": [
    {
      "endpointId": "ept_6j7BNZus3ZyPy6P7QtLUMCC3Rq7h",
      "url": "https://www.upstash.com",
      "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJA"
    }
  ]
}