Subscriptions

Tag subscriptions allow to subscribe users to a tag. If a new question with this tag is published, the users which are subscribed will receive a notification.

It is also possible to subscribe a user to a list of tags.


Get subscribers by tag label

GET /tag-labels/:TAGLABEL/subscribers

Use percent encoding for special characters in the :TAGLABEL segment of the endpoint URL.

Response

HTTP 404 NOT FOUND if the tag with given label does not exist.

A list of all subscribed users:

[
        {
            "location": "London",
            "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
            "firstname": "Siger",
            "email": "siger.holmes@example.com",
            "is_deleted": false,
            "country": "uk",
            "lastname": "Holmes",
            "id": 17309,
            "language": "en",
            "about": "Father of Sherlock. Inactive",
            "gender": "m",
            "first_seen": "2015-02-02T11:31:05.000Z",
            "last_seen": "2015-08-09T11:31:05.000Z",
            "customfields": { "occupation": "Detective" },
            "score_level": null,
            "score_points": null
        }
]


Subscribe users by tag label

PUT /tag-labels/:TAGLABEL/subscribers

Use percent encoding for special characters in the :TAGLABEL segment of the endpoint URL.

INFO:Replaces all existing subscribers!

Json Payload

A list of user IDs:

[
  17309,
  17310 
]

Non-existing user IDs and those of deleted users will be silently ignored.

Response

HTTP 404 NOT FOUND if the tag with given label does not exist.

An updated list of subscribed users:

[
    {
        "location": "London",
        "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
        "firstname": "Siger",
        "email": "siger.holmes@example.com",
        "is_deleted": false,
        "is_hidden": false,
        "is_system": false,
        "country": "uk",
        "lastname": "Holmes",
        "id": 17309,
        "language": "en",
        "about": "Father of Sherlock. Inactive",
        "gender": "m",
        "first_seen": "2015-02-02T11:31:05.000Z",
        "last_seen": "2015-08-09T11:31:05.000Z",
        "customfields": { "occupation": "Detective" },
        "score_level": null,
        "score_points": null
    },
    {
        "location": "London",
        "image": "http://cdn.starmind.com:8080/static/user/default.jpg",
        "firstname": "Sherlock",
        "email": "sherlock.holmes@example.com",
        "is_deleted": false,
        "is_hidden": false,
        "is_system": false,
        "country": "uk",
        "lastname": "Holmes",
        "id": 17310,
        "language": "en",
        "about": "Detective",
        "gender": "m",
        "first_seen": "2015-02-02T11:31:05.000Z",
        "last_seen": "2015-08-09T11:31:05.000Z",
        "customfields": { "occupation": "Detective" },
        "score_level": null,
        "score_points": null
    }
]