List repositories

GET /api/v1/repos

List all repositories in your organization with pagination support.

GET /api/v1/repos?cursor=CURSOR&limit=20
Authorization: Bearer YOUR_JWT_TOKEN

Parameters

Parameter	Type	Description
cursor	Optional	Pagination cursor from previous response (base64 encoded)
limit	Optional	Maximum number of repositories to return (default: 20, max: 100)

JWT Requirements

• Requires org:read scope

Response

{
  "repos": [
    {
      "repo_id": "V1StGXR8_Z5jdHi6B-myT",
      "url": "team/project-alpha",
      "default_branch": "main",
      "created_at": "2024-01-15T10:30:00Z",
      "base_repo": {
        "provider": "github",
        "owner": "octocat",
        "name": "Hello-World"
      }
    },
    {
      "repo_id": "p5QH0e2K9b8cW3t8aYxZ1",
      "url": "team/project-beta",
      "default_branch": "main",
      "created_at": "2024-01-16T14:20:00Z"
    }
  ],
  "next_cursor": "MTcwNTQyODc0MDAwMDAwMDAwMHxwNVFIMGUySzliOGNXM3Q4YVl4WjE",
  "has_more": true
}

Response Fields

Field	Type	Description
repos	Array	List of repository objects
repos[].repo_id	String	Internal repository ID
repos[].url	String	Repository URL path (matches the JWT repo claim)
repos[].default_branch	String	Default branch name
repos[].created_at	String	ISO 8601 creation timestamp
repos[].base_repo	Optional	GitHub sync configuration (if configured)
next_cursor	Optional	Opaque cursor for the next page (absent when no more results)
has_more	Boolean	Whether more repositories exist

Notes

• The next_cursor value should be used for fetching the next page
• Repositories are returned in creation order
• The base_repo field is only present for repositories synced with GitHub

Error Responses

Status	Description
401 Unauthorized	Invalid JWT or missing org:read scope