Topics API

List Active Topics

GET /v2/utilities/topics

Returns all topics that currently have at least one subscriber.

Example

curl "https://api.cloudsignal.app/v2/utilities/topics" \
  -H "X-Secret-Key: sk_your_secret_key"

Response

{
  "topics": [
    { "topic": "chat/lobby", "subscriber_count": 12 },
    { "topic": "sensors/temp/#", "subscriber_count": 3 }
  ]
}

Get Topic Subscribers

GET /v2/utilities/topics/{topic}/subscribers

Returns the list of users subscribed to a specific topic.

Example

curl "https://api.cloudsignal.app/v2/utilities/topics/chat%2Flobby/subscribers" \
  -H "X-Secret-Key: sk_your_secret_key"

Response

{
  "topic": "chat/lobby",
  "subscribers": [
    { "username": "alice", "client_id": "client-abc", "qos": 1 },
    { "username": "bob", "client_id": "client-def", "qos": 0 }
  ],
  "count": 2
}

Get Topic Info

GET /v2/utilities/topics/{topic}/info

Returns detailed information about a specific topic.

Get User's Topics

GET /v2/utilities/users/{username}/topics

Returns all topics a specific user is subscribed to.

On this page