Skip to content

Your subscription to an issue or pull request, named by a thread's id, or by repo and number.

GET/notifications/threads/{id}/subscription

subscribed says whether you hear of what happens on it, ignored whether you hear of nothing at all, and reason why you are subscribed: you opened it or asked g1t for it (author), are assigned (assign), were asked to review (review_requested), commented (comment), were mentioned (mention), or subscribed by hand (manual).

Name Type Required Description
id string Yes A thread’s id, from list_notifications. Or give repo and number.
curl https://api.g1t.sh/notifications/threads/ntf_01kp7m2q3r4s5t6v7w8x9y0z1a/subscription \
-H "Authorization: Bearer $G1T_TOKEN"

A successful request answers 200 with:

{
"subscribed": true,
"ignored": false,
"reason": "review_requested",
"repo": "flagon-io/hello",
"number": 14,
"updated_at": null
}

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status Code When
401 unauthenticated A token is required, or the one sent is not valid.
403 forbidden The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository.
404 not_found It does not exist, or you cannot see it.
422 invalid The input is not valid. message says which field and why.