List Repositories

Retrieve all GitHub repositories accessible to the authenticated user with connection status

GET /api/v1/repos

List Repositories

cURL

curl --request GET \
  --url https://api.example.com/api/v1/repos

200

{
  "repositories": [
    {
      "id": 123,
      "name": "<string>",
      "full_name": "<string>",
      "description": {},
      "private": true,
      "html_url": "<string>",
      "updated_at": "<string>",
      "is_connected": true,
      "installation_id": {}
    }
  ]
}

Overview

This endpoint fetches all GitHub repositories the user has access to and annotates them with their connection status to Nectr AI. The response includes repositories where the user is an owner, collaborator, or organization member.

Authentication

Requires a valid JWT token in the Authorization header.

Authorization: Bearer <token>

Request

cURL

curl -X GET "https://api.nectr.ai/api/v1/repos" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response

Returns an array of repository objects with connection metadata.

repositories · array

Array of repository objects

id · integer

GitHub repository ID

name · string

Repository name (without owner)

full_name · string

Full repository name in owner/repo format

description · string | null

Repository description from GitHub

private · boolean

Whether the repository is private

html_url · string

GitHub URL to the repository

updated_at · string

ISO 8601 timestamp of last repository update

is_connected · boolean

Whether this repository is connected to Nectr AI

installation_id · integer | null

Database ID of the installation record if connected, otherwise null

Example Response

[
  {
    "id": 123456789,
    "name": "my-backend",
    "full_name": "acme/my-backend",
    "description": "Production API backend",
    "private": true,
    "html_url": "https://github.com/acme/my-backend",
    "updated_at": "2026-03-10T14:32:10Z",
    "is_connected": true,
    "installation_id": 42
  },
  {
    "id": 987654321,
    "name": "frontend-app",
    "full_name": "acme/frontend-app",
    "description": null,
    "private": false,
    "html_url": "https://github.com/acme/frontend-app",
    "updated_at": "2026-03-08T09:15:22Z",
    "is_connected": false,
    "installation_id": null
  }
]

Error Responses

401 Unauthorized

JWT token is invalid, expired, or missing

{
  "detail": "Unauthorized"
}

401 Session Expired

GitHub OAuth token cannot be decrypted (SECRET_KEY changed)

{
  "detail": "Session expired — please log out and sign in again to reconnect your GitHub account."
}

502 Bad Gateway

Failed to fetch repositories from GitHub API

{
  "detail": "Failed to fetch repositories from GitHub"
}

Implementation Details

GitHub API Pagination

The endpoint automatically handles GitHub API pagination, fetching up to 100 repositories per page until all accessible repositories are retrieved.

Repository Filtering

Repositories are fetched with the following GitHub API parameters:

• affiliation: owner,collaborator,organization_member
• sort: updated (most recently updated first)
• per_page: 100

Connection Status

The is_connected field is determined by checking for an active Installation record in the database where:

• user_id matches the current user
• repo_full_name matches the repository
• is_active is true