curl --location --request POST 'https://api.userorbit.com/v1/public/topics.subscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "topic-uuid-123"
}'
const response = await fetch('https://api.userorbit.com/v1/public/topics.subscribe', {
method: 'POST',
headers: {
'Authorization': `Bearer ${subscriberToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ id: topicId })
});
const { data } = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/topics.subscribe',
headers={
'Authorization': f'Bearer {subscriber_token}',
'Content-Type': 'application/json'
},
json={'id': topic_id}
)
{
"data": {
"topicSubscriber": {
"id": "subscription-uuid",
"topicId": "topic-uuid-123",
"subscriberId": "sub-uuid-789",
"createdAt": "2024-01-17T15:30:00Z"
},
"ok": true
}
}
Topics
Subscribe to Topic
Subscribe to notifications for a topic. Get notified of comments, votes, and status changes.
POST
/
v1
/
public
/
topics.subscribe
curl --location --request POST 'https://api.userorbit.com/v1/public/topics.subscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "topic-uuid-123"
}'
const response = await fetch('https://api.userorbit.com/v1/public/topics.subscribe', {
method: 'POST',
headers: {
'Authorization': `Bearer ${subscriberToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ id: topicId })
});
const { data } = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/topics.subscribe',
headers={
'Authorization': f'Bearer {subscriber_token}',
'Content-Type': 'application/json'
},
json={'id': topic_id}
)
{
"data": {
"topicSubscriber": {
"id": "subscription-uuid",
"topicId": "topic-uuid-123",
"subscriberId": "sub-uuid-789",
"createdAt": "2024-01-17T15:30:00Z"
},
"ok": true
}
}
Authentication
Authorization: Bearer SUBSCRIBER_JWT_TOKEN
Request Body
string
required
Topic ID (UUID) to subscribe to
Response
curl --location --request POST 'https://api.userorbit.com/v1/public/topics.subscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": "topic-uuid-123"
}'
const response = await fetch('https://api.userorbit.com/v1/public/topics.subscribe', {
method: 'POST',
headers: {
'Authorization': `Bearer ${subscriberToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ id: topicId })
});
const { data } = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/topics.subscribe',
headers={
'Authorization': f'Bearer {subscriber_token}',
'Content-Type': 'application/json'
},
json={'id': topic_id}
)
{
"data": {
"topicSubscriber": {
"id": "subscription-uuid",
"topicId": "topic-uuid-123",
"subscriberId": "sub-uuid-789",
"createdAt": "2024-01-17T15:30:00Z"
},
"ok": true
}
}
Behavior
- Event Trigger: Fires
topic-subscribers.createevent - Team Validation: Subscriber must belong to same team
- Idempotent: Safe to call multiple times
Notes
- Triggers webhook event for integrations
- Subscriber receives notifications for topic updates
Was this page helpful?

