GitHub

Integrate Aiqaramba with GitHub to create issues from test run findings and list accessible repositories. Requires a GitHub account to be connected via tenant settings (OAuth). When an agent discovers a bug, you can automatically generate a detailed GitHub issue with reproduction steps extracted from the agent's browser session.

Setup

Go to Integrations and click Connect GitHub. Authorize the application to access your repositories.

Once connected, you can create issues from any completed or failed agent. Open the agent detail page and click Create GitHub Issue to generate a structured bug report with reproduction steps.

GET /api/v1/github/repos

List GitHub repositories

Returns repositories accessible via the tenant's connected GitHub account. Use this to discover which repos are available as targets for issue creation.

Status Codes

CodeDescription
200OK
400GitHub not configured
401Unauthorized
502GitHub API error

Response Body

[
  {
    "id": 123456,
    "name": "webapp",
    "full_name": "acme/webapp",
    "private": false,
    "html_url": "https://github.com/acme/webapp"
  }
]
GET /api/v1/github/repos
cURL
Response
POST /api/v1/agents/{id}/github-issue

Create GitHub issue from agent

Generates a GitHub issue from the test run's conversation history. An LLM analyzes the agent's browser session to produce a structured issue with title, description, reproduction steps, and expected vs actual behavior. The agent must be in a terminal state (completed, failed, or stopped).

Parameters

ParameterTypeInRequiredDescription
iduuidpathYesTest run ID
repostringbodyYesTarget repository in owner/repo format
labelsarraybodyNoLabels to apply to the issue

Status Codes

CodeDescription
201Issue created
400Validation error or agent not in terminal state
401Unauthorized
404Agent not found
502GitHub API error

Response Body

{
  "number": 42,
  "html_url": "https://github.com/acme/webapp/issues/42",
  "title": "Bug: Checkout form validation fails for international addresses"
}
POST /api/v1/agents/{id}/github-issue
cURL
Response