> ## Documentation Index > Fetch the complete documentation index at: https://docs.entire.com/llms.txt > Use this file to discover all available pages before exploring further. # Your trails across all repositories > Trails you authored or that are assigned to you across every repository you belong to, newest first. A trail that you authored and that is assigned to you appears once. The timeframe bounds when a trail was last updated, not when it was opened, and repositories with trails turned off are left out. This list has no cursor: it returns up to `limit` rows inside the timeframe and no `next_cursor`; narrow the timeframe or raise `limit` to see more. ## OpenAPI ````yaml https://aws-us-east-2.api.entire.io/api/v1/openapi.json?section=sessions get /me/trails openapi: 3.1.0 info: title: Entire API version: 0.1.0 description: >- Unified Entire API gateway. Aggregates the control plane and regional repository-operation services behind a single endpoint. servers: - url: https://aws-us-east-2.api.entire.io/api/v1 security: - bearerAuth: [] tags: - name: search description: Operations under the /search surface. - name: semantic-search description: Operations under the /semantic-search surface. - name: brainstore description: Operations served by the brainstore service. - description: >- The authenticated caller's own cross-repo activity, commits, checkpoints, sessions, and recap. name: me x-group: Your activity - description: >- Residency-aware previews of the caller's surface, served under /experimental. Shapes may change without notice. name: experimental - description: >- Per-user settings: pinned and recent repos, diff view, and saved filter tabs. name: preferences - description: >- Repository discovery list, metadata, and headline rollups (summary, activity, contributors, agents). name: repos - description: >- Git browsing for a repo: commits, commit detail, branch compare, tree listings, raw file bytes, and branches. name: code - description: >- Checkpoint listing, resolution, LLM analysis, transcripts, and per-repo checkpoint status. name: checkpoints x-group: Checkpoints - description: >- Materialised sessions: listing, detail, transcripts, rename, and the public-share toggle. name: sessions x-group: Sessions - description: >- Repo dashboard aggregates under /overview: commit and checkpoint stats, contributor breakdowns, and session patterns. name: overview - description: Live ref-change stream for a repo (SSE). name: refs x-group: Ref events - description: >- Trails themselves: list, create, read, update, delete, plus per-repo counts, claimed branches, and the body-document ensure. name: trails x-group: Trails - description: >- What has happened on a trail: the merged timeline, the event stream, and who is watching (per trail, plus a repo-wide roll-up). name: trail-activity x-group: Activity - description: >- Conversation on a trail: discussions, their messages, and the live discussion-event stream. name: trail-discussions x-group: Discussions - description: >- Code review on a trail: review state, comments, diffs, reviewed files, and review re-runs. name: trail-reviews x-group: Reviews - description: >- Runner output on a trail: the latest result per configured runner, monitor results, and manual launches. name: trail-runs - description: >- Quality gates: repo gate definitions, gate settings, repo-authored monitor definitions, and a trail's gate evaluation. name: trail-gates x-group: Gates - description: >- Getting a trail landed: approval decisions, merge readiness, and the merge itself. name: trail-approvals x-group: Approvals - description: >- Trail attachment blobs: upload intent, completion, retrieval, and deletion. name: trail-attachments - description: Project-scoped Trails, and their owned repository Changes and discussions. name: projects - description: Agent-provenance ranking for a repo's code scopes. name: experts x-group: Experts - description: >- git-meta-compatible repo metadata read and write (git is the source of truth). name: git-meta - description: >- A project's versioned agents — what each runs (its own runner or an Entire preset), what it is called, the environment it runs in, the repositories it reviews and its trigger — and Entire's presets. Saving one runs nothing. name: agents - description: >- A project's saved, versioned Environments — where an agent runs: provider and sandbox lifetime — reusable across the project's repositories and agents. Configuration only: saving one provisions nothing. name: environments - description: >- Runs of a project's agents, each on one Change: starting one, the immutable snapshot each captured, status, output and results, retry and cancel. name: runs - description: >- Mutating repo configuration: runner, trail, public-sharing, and gate-enforcement settings (requires repo manage_settings for every forge). name: repo-settings - description: The caller's open pull requests across their repositories. name: pull-requests - description: 'Service-authed only: editor-document sync behind the trail body editor.' name: trails-internal - description: The runner OIDC issuer's discovery document and JWKS. Machine-consumed. name: runner-issuer - name: repositories x-group: Git paths: /me/trails: get: tags: - me summary: Your trails across all repositories description: >- Trails you authored or that are assigned to you across every repository you belong to, newest first. A trail that you authored and that is assigned to you appears once. The timeframe bounds when a trail was last updated, not when it was opened, and repositories with trails turned off are left out. This list has no cursor: it returns up to `limit` rows inside the timeframe and no `next_cursor`; narrow the timeframe or raise `limit` to see more. operationId: listMyTrails parameters: - description: Relative window explode: false in: query name: timeframe schema: default: last-6-months description: Relative window enum: - last-month - last-3-months - last-6-months type: string - description: RFC 3339; overrides timeframe start explode: false in: query name: since schema: description: RFC 3339; overrides timeframe start type: string - description: RFC 3339; overrides timeframe end explode: false in: query name: until schema: description: RFC 3339; overrides timeframe end type: string - explode: false in: query name: limit schema: default: 500 format: int64 maximum: 1000 minimum: 1 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/MeTrailsOutputBody' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Forbidden '422': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Unprocessable Entity '429': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Too Many Requests '500': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Internal Server Error '503': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Service Unavailable security: - oauth2: [] - oidc: [] - bearerAuth: [] components: schemas: MeTrailsOutputBody: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - /api/v1/schemas/MeTrailsOutputBody.json format: uri readOnly: true type: string meta: $ref: '#/components/schemas/Meta' timeframe: type: string trails: items: $ref: '#/components/schemas/MeTrail' type: - array - 'null' updated_at: type: string required: - trails - timeframe - updated_at - meta type: object ApiError: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - /api/v1/schemas/ApiError.json format: uri readOnly: true type: string code: type: string detail: type: string error: type: string required: - error type: object Meta: additionalProperties: false properties: degraded: description: Code for degraded behaviour type: string partial: description: >- Codes for partial-result conditions: team_stats_foreign_region, unroutable_repos, unroutable_projects, unresolved_caller_login, change_readiness_unavailable items: type: string type: - array - 'null' server_time: format: date-time type: string required: - server_time type: object MeTrail: additionalProperties: false properties: assignee_identities: items: $ref: '#/components/schemas/TrailAssigneeIdentity' type: - array - 'null' assignees: items: type: string type: - array - 'null' author: $ref: '#/components/schemas/TrailAuthor' base: type: string branch: type: - string - 'null' comment_count: type: integer format: int64 created_at: format: date-time type: string has_code_changes: type: boolean id: type: string is_private: type: boolean last_activity_at: description: >- Latest meaningful activity on the Change; excludes background bookkeeping and falls back to created_at until activity is recorded. format: date-time type: string merged_at: format: date-time type: - string - 'null' number: type: integer format: int64 original_branch: type: - string - 'null' parent: allOf: - description: >- Discoverable project parent on list/detail reads; absence does not prove the work is parentless - $ref: '#/components/schemas/TrailParentReference' phase: type: - string - 'null' priority: type: string provider: description: >- Route identity of the repo the trail lives in: which product surface links to it enum: - github - entire type: string ready_for_review: type: boolean repo_full_name: type: string repo_id: type: string reviewers: items: $ref: '#/components/schemas/TrailReviewer' type: - array - 'null' status: type: string title: type: string type: type: string unresolved_count: type: integer format: int64 updated_at: format: date-time type: string url: description: >- Web app page for this code work; absent when this deployment has no frontend origin type: string required: - provider - repo_id - repo_full_name - is_private - id - number - title - status - branch - original_branch - base - type - priority - author - assignees - assignee_identities - reviewers - ready_for_review - has_code_changes - comment_count - unresolved_count - created_at - updated_at - merged_at - last_activity_at - phase type: object TrailAssigneeIdentity: additionalProperties: false properties: identity: $ref: '#/components/schemas/ContributorIdentity' login: type: - string - 'null' required: - login - identity type: object TrailAuthor: additionalProperties: false properties: id: type: string identity: $ref: '#/components/schemas/ContributorIdentity' login: type: - string - 'null' required: - id - login - identity type: object TrailParentReference: additionalProperties: false properties: host: enum: - gh - et type: string id: type: string jurisdiction: description: Project jurisdiction from Core; empty when unresolved type: string number: description: Project-local Trail number, not the repository Trail number format: int64 type: integer path: description: API-relative parent detail path in the project's cell type: string primary_processing_cell: description: >- Project cell ID from Core; empty when unassigned (do not infer from the repository) type: string project: description: Canonical public project name, never its internal storage name type: string project_id: type: string url: description: >- Web app page for the parent Trail; absent when this deployment has no frontend origin type: string required: - id - number - project_id - host - project - path - jurisdiction - primary_processing_cell type: object TrailReviewer: additionalProperties: false properties: actor_account_id: type: string identity: $ref: '#/components/schemas/ContributorIdentity' is_approval_stale: type: boolean login: type: string status: type: string required: - login - status - identity type: object ContributorIdentity: additionalProperties: false properties: account_id: type: - string - 'null' automation: $ref: '#/components/schemas/AutomationIdentity' avatar_url: type: - string - 'null' display_name: type: - string - 'null' handles: items: $ref: '#/components/schemas/IdentityHandle' type: - array - 'null' kind: type: string username: type: string required: - kind - account_id - display_name - avatar_url - handles type: object AutomationIdentity: additionalProperties: false properties: automation_id: description: >- The automation's aut_ subject, for an automation that is not a plugin installation. type: string installation_id: description: The plugin installation's ins_ id. type: string plugin: description: The plugin's slug. type: string type: object IdentityHandle: additionalProperties: false properties: handle: type: string is_primary: type: boolean provider: type: string required: - provider - handle type: object securitySchemes: bearerAuth: bearerFormat: JWT description: >- Bearer token authorizing this operation's repository action. Each operation's security requirement names the resource action the token must be authorized for (pull or push). scheme: bearer type: http oauth2: description: OAuth 2.0 authorization code flow. flows: authorizationCode: authorizationUrl: https://us.auth.entire.io/authorize scopes: offline_access: Stay signed in and receive a refresh token. openid: Verify your identity. tokenUrl: https://us.auth.entire.io/oauth/token type: oauth2 oidc: description: >- OpenID Connect discovery document: https://us.auth.entire.io/.well-known/openid-configuration openIdConnectUrl: https://us.auth.entire.io/.well-known/openid-configuration type: openIdConnect ````