Get a topic

Retrieves a topic

GET /v2/topics/{topicName}

curl

curl https://qstash.upstash.io/v2/topics/my-topic \
  -H "Authorization: Bearer <token>"

const response = await fetch('https://qstash.upstash.io/v2/topics/my-topic', {
  headers: {
    'Authorization': 'Bearer <token>'
  }
});

import requests

headers = {
    'Authorization': 'Bearer <token>',
}

response = requests.get(
  'https://qstash.upstash.io/v2/topics/my-topic',
   headers=headers
)

req, err := http.NewRequest("GET", "https://qstash.upstash.io/v2/topics/my-topic", nil)
if err != nil {
  log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer <token>")
resp, err := http.DefaultClient.Do(req)
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

200 OK

{
 
  "createdAt": 1623345678001,
  "updatedAt": 1623345678001,
  "name": "my-topic",
  "endpoints": [
    {
      "name": "my-endpoint",
      "url": "https://my-endpoint.com"
    }
  ]
}

Request

topicName · string · required

The name of the topic to retrieve.

Response

createdAt · int · required

The creation time of the topic. UnixMilli

updatedAt · int · required

The update time of the topic. UnixMilli

name · string · required

The name of the topic.

endpoints · Array · required

Show child attributes

name · string

The name of the endpoint

url · string · required

The URL of the endpoint

curl

curl https://qstash.upstash.io/v2/topics/my-topic \
  -H "Authorization: Bearer <token>"

const response = await fetch('https://qstash.upstash.io/v2/topics/my-topic', {
  headers: {
    'Authorization': 'Bearer <token>'
  }
});

import requests

headers = {
    'Authorization': 'Bearer <token>',
}

response = requests.get(
  'https://qstash.upstash.io/v2/topics/my-topic',
   headers=headers
)

req, err := http.NewRequest("GET", "https://qstash.upstash.io/v2/topics/my-topic", nil)
if err != nil {
  log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer <token>")
resp, err := http.DefaultClient.Do(req)
if err != nil {
  log.Fatal(err)
}
defer resp.Body.Close()

200 OK

{
 
  "createdAt": 1623345678001,
  "updatedAt": 1623345678001,
  "name": "my-topic",
  "endpoints": [
    {
      "name": "my-endpoint",
      "url": "https://my-endpoint.com"
    }
  ]
}