GitHub

create_issue

Open a new issue.

Request body:

{
  "user_id": "...",
  "action": "create_issue",
  "payload": { "repo": "owner/repo", "title": "Bug: X is broken", "body": "Details here" },
  "target_app": "github"
}

provider_response.result shape:

{ "number": 42, "html_url": "https://github.com/owner/repo/issues/42" }

list_issues

List open issues in a repo.

Request body:

{
  "user_id": "...",
  "action": "list_issues",
  "payload": { "repo": "owner/repo" },
  "target_app": "github"
}

provider_response.result shape:

[ {"number":42,"title":"..."} ]

close_issue

Close an issue.

Request body:

{
  "user_id": "...",
  "action": "close_issue",
  "payload": { "repo": "owner/repo", "issueNumber": 42 },
  "target_app": "github"
}

provider_response.result shape:

{ "number": 42, "state": "closed" }

add_comment

Comment on an issue or PR.

Request body:

{
  "user_id": "...",
  "action": "add_comment",
  "payload": { "repo": "owner/repo", "issueNumber": 42, "body": "Looking into this" },
  "target_app": "github"
}

provider_response.result shape:

{ "id": 123, "body": "Looking into this" }

star_repo

Star a repository.

Request body:

{
  "user_id": "...",
  "action": "star_repo",
  "payload": { "owner": "octocat", "repo": "Hello-World" },
  "target_app": "github"
}

provider_response.result shape:

{} (204 No Content on success)

custom

Escape hatch — call any GitHub REST endpoint directly with your own path/method/body.

Request body:

{
  "user_id": "...",
  "action": "custom",
  "payload": { "path": "repos/owner/repo/pulls", "method": "GET" },
  "target_app": "github"
}

provider_response.result shape:

[ {...pull requests...} ]

404 "Not Found" on a repo you know exists

Cause: Your token lacks access — usually a private repo with only "public_repo" scope.

Fix: Regenerate the token with full "repo" scope.

401 Bad credentials (inside provider_response)

Cause: Token is wrong, expired, or was revoked.

Fix: Generate a fresh token and update your Connections page.