---
title: "Recent authored or assigned project Trails across regions"
method: GET
path: "/api/v1/me/project-trails"
tags: ["Project Trails"]
---

# Recent authored or assigned project Trails across regions

`GET /api/v1/me/project-trails`

## 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/me/project-trails`
- Auth: none declared

Bounded first-page summary for the sidebar. Calls each region's /me/project-trails using the authenticated caller. Does not expose regional cursors.

## Query parameters

- `status` string[]
- `phase` string[]
- `type` string[]
- `priority` string[]
- `per_page` integer
- `sort` 'updated' | 'title'
- `phase_not` string[]

## Response `200`

Recent project Trails

- object
  - `items` object[], required
    - `id` string, required
    - `number` integer, required
    - `title` string, required
    - `phase` 'planning' | 'building' | 'complete' | 'closed', required
    - `lastActivityAt` string, required
    - `lastVisitedAt` string, date-time, nullable
    - `project` object, required
      - `id` string, required
      - `name` string, required
      - `provider` 'github' | 'entire', required
      - `reference` object, required
        - `forge` 'gh' | 'et', required
        - `project` string, required
      - `jurisdiction` string, required
      - `primaryProcessingCell` string
      - `capabilities` object, required
        - `canManageTrails` boolean, required
    - `repositories` object[]
      - `id` string, required
      - `name` string, required
    - `changes` object[]
      - `id` string, required
      - `repository_id` string, required
      - `repository` string, required
      - `branch` string, required
      - `number` integer, required
      - `title` string, required
      - `status` string, required
      - `has_code_changes` boolean, required
      - `ready_for_review` boolean, required
      - `readiness` 'ready' | 'in_review' | 'none' | 'unknown'
      - `mergeability` union
        - object
          - `mergeable` boolean, required
          - `conflict_status` 'clean' | 'conflicting' | 'unknown', required
          - `head_sha` string, required
          - `refreshed_at` string, date-time, nullable, required
          - `forge_merge_block` string, nullable, required
        - object
          - `mergeable` boolean, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `last_activity_at` string, date-time, required
  - `partial` string[], required

## Changes

- **2026-10-23** `0e6f9646fe03`: 2 breaking, 2 info
  - the `items/items/changes/items/mergeability/anyOf[subschema #1]/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/changes/items/mergeability/anyOf[subschema #1]/mergeable` from the response with the `200` status
  - added the optional property `items/items/changes/items/readiness` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `items/items/changes/items/mergeability/anyOf[subschema #1]/` response property `anyOf` list for the response status `200`
- **2026-10-13** `c0fa2c3c764e`: 2 breaking, 3 info
  - removed the required property `items/items/changes/items/needs_attention` from the response with the `200` status
  - removed the required property `items/items/updatedAt` from the response with the `200` status
  - added the optional property `items/items/changes/items/mergeability` to the response with the `200` status
  - added the required property `items/items/changes/items/last_activity_at` to the response with the `200` status
  - …1 more
- **2026-10-12** `ccbabda01696`: 3 info
  - added the optional property `items/items/changes` to the response with the `200` status
  - added the optional property `items/items/lastVisitedAt` to the response with the `200` status
  - added the optional property `items/items/repositories` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/me/project-trails/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)