Skip to content

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

GET/repos/{owner}/{name}/issues/{number}/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
owner string Yes The workspace that owns the repository.
name string Yes The repository’s name.
number integer Yes With repo: the issue or pull request’s number.
curl https://api.g1t.sh/repos/flagon-io/hello/issues/14/subscription \
-H "Authorization: Bearer $G1T_TOKEN"

A successful request answers 200 with:

{
"subscribed": true,
"ignored": false,
"reason": "author",
"repo": null,
"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.