---
title: "List readable repositories with Trails enabled in a project"
method: GET
path: "/api/v1/trails/repos"
tags: ["Project Trails"]
---

# List readable repositories with Trails enabled in a project

`GET /api/v1/trails/repos`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/trails/repos`
- Auth: none declared

## Query parameters

- `project_id` string, required
- `permission` 'read' | 'write'
- `cell` string

## Response `200`

Trails-enabled repositories, including those without existing Trails

- object
  - `repositories` object[], required
    - `id` string, required
    - `full_name` string, required
    - `forge` 'github' | 'entire', required

## Other responses

- `400`: Request rejected or upstream unavailable
- `401`: Request rejected or upstream unavailable
- `403`: Request rejected or upstream unavailable
- `404`: Request rejected or upstream unavailable
- `422`: Request rejected or upstream unavailable
- `502`: Request rejected or upstream unavailable
- `503`: Request rejected or upstream unavailable

## Changes

- **2026-10-26** `82deb2eae7c6`: 2 info
  - added the new optional `query` request parameter `cell`
  - added the new optional `query` request parameter `permission`
- **2026-10-24** `d52138699fd7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/trails/repos/get.md)

---

[API](https://skmtc.dev/entire/apis/entire-api.md) - [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/entire/apis/entire-api/revisions/a24dfcc828d7?raw)