> ## 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.

# Endpoints

> Browse published API endpoints by resource.

Browse the published callable endpoints below. Reference pages provide credential, permission and Experimental details where documented. For plugin-capable endpoints, see [Endpoints in Plugins](https://docs.entire.com/guides/api/plugins/apis.md).

Paths are relative to the server shown on the reference page. Start with [Getting Started](https://docs.entire.com/guides/api/getting-started.md), [Authentication](https://docs.entire.com/guides/api/authentication.md) and [Regions and routing](https://docs.entire.com/guides/api/regions-and-routing.md) to choose credentials and the correct host. Outbound event definitions are documented separately in [Webhooks](https://docs.entire.com/guides/api/plugins/webhooks.md).

## Accounts and projects

### Clusters

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /clusters</td><td>[List data-plane clusters attached to this control plane](https://docs.entire.com/api-reference/control-plane/clusters/list-data-plane-clusters-attached-to-this-control-plane.md)</td></tr>
  </tbody>
</table>

### Account

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /me</td><td>[Get the calling account's identity and profile](https://docs.entire.com/api-reference/control-plane/identity/get-the-calling-accounts-identity-and-profile.md)</td></tr>
  </tbody>
</table>

### Organizations

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /orgs</td><td>[List organizations the caller can see (or one by name)](https://docs.entire.com/api-reference/control-plane/orgs/list-organizations-the-caller-can-see-or-one-by-name.md)</td></tr>
    <tr><td>GET /orgs<wbr />/\{orgId}</td><td>[Get an organization](https://docs.entire.com/api-reference/control-plane/orgs/get-an-organization.md)</td></tr>
    <tr><td>GET /orgs<wbr />/\{orgId}<wbr />/members</td><td>[List members of an organization](https://docs.entire.com/api-reference/control-plane/orgs/list-members-of-an-organization.md)</td></tr>
  </tbody>
</table>

### Projects

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /orgs<wbr />/\{orgId}<wbr />/projects</td><td>[List projects owned by an organization](https://docs.entire.com/api-reference/control-plane/projects/list-projects-owned-by-an-organization.md)</td></tr>
    <tr><td>GET /projects</td><td>[List projects accessible to the caller (or one by name)](https://docs.entire.com/api-reference/control-plane/projects/list-projects-accessible-to-the-caller-or-one-by-name.md)</td></tr>
    <tr><td>GET /projects<wbr />/resolve<wbr />/\{host}<wbr />/\{project}</td><td>[Resolve a canonical project reference](https://docs.entire.com/api-reference/control-plane/projects/resolve-a-canonical-project-reference.md)</td></tr>
    <tr><td>GET /projects<wbr />/\{projectId}</td><td>[Get a project by id](https://docs.entire.com/api-reference/control-plane/projects/get-a-project-by-id.md)</td></tr>
  </tbody>
</table>

### Repositories

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /projects<wbr />/\{projectId}<wbr />/repos</td><td>[List repositories in a project (or one by name)](https://docs.entire.com/api-reference/control-plane/repos/list-repositories-in-a-project-or-one-by-name.md)</td></tr>
    <tr><td>GET /repos</td><td>[List the caller's readable repositories (placement index)](https://docs.entire.com/api-reference/control-plane/repos/list-the-callers-readable-repositories-placement-index.md)</td></tr>
    <tr><td>POST /repos</td><td>[Create repository](https://docs.entire.com/api-reference/control-plane/repos/create-repository.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repoId}</td><td>[Get repository](https://docs.entire.com/api-reference/control-plane/repos/get-repository.md)</td></tr>
  </tbody>
</table>

## Git

### Git

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /git<wbr />/repos<wbr />/resolve</td><td>[Resolve repository path](https://docs.entire.com/api-reference/git/repositories/resolve-repository-path.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/branches</td><td>[List branches](https://docs.entire.com/api-reference/git/repositories/list-branches.md)</td></tr>
    <tr><td>POST /git<wbr />/repos<wbr />/\{repoId}<wbr />/branches</td><td>[Create branch at a commit](https://docs.entire.com/api-reference/git/repositories/create-branch-at-a-commit.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/commits</td><td>[List commits](https://docs.entire.com/api-reference/git/repositories/list-commits.md)</td></tr>
    <tr><td>POST /git<wbr />/repos<wbr />/\{repoId}<wbr />/commits<wbr />/batch</td><td>[Get commits by SHA in batch](https://docs.entire.com/api-reference/git/repositories/get-commits-by-sha-in-batch.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/compare</td><td>[Compare commits](https://docs.entire.com/api-reference/git/repositories/compare-commits.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/diff</td><td>[Get unified diff](https://docs.entire.com/api-reference/git/repositories/get-unified-diff.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/merge-base</td><td>[Get merge base](https://docs.entire.com/api-reference/git/repositories/get-merge-base.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/raw<wbr />/\{path...}</td><td>[Get raw file by path](https://docs.entire.com/api-reference/git/repositories/get-raw-file-by-path.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/refs</td><td>[List references](https://docs.entire.com/api-reference/git/repositories/list-references.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/tags</td><td>[List tags](https://docs.entire.com/api-reference/git/repositories/list-tags.md)</td></tr>
    <tr><td>GET /git<wbr />/repos<wbr />/\{repoId}<wbr />/tree</td><td>[Get tree](https://docs.entire.com/api-reference/git/repositories/get-tree.md)</td></tr>
  </tbody>
</table>

### Ref events

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/refs<wbr />/events</td><td>[Stream live ref (branch/tag/HEAD) change events for a repository](https://docs.entire.com/api-reference/git/refs/stream-live-ref-branchtaghead-change-events-for-a-repository.md)</td></tr>
  </tbody>
</table>

## Trails

### Trails

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails</td><td>[List a repo's trails (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trails/list-a-repos-trails-repo_id-addressing.md)</td></tr>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails</td><td>[Create a trail by repo id](https://docs.entire.com/api-reference/trails/trails/create-a-trail-by-repo-id.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}</td><td>[Get a trail by number (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trails/get-a-trail-by-number-repo_id-addressing.md)</td></tr>
    <tr><td>PATCH /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}</td><td>[Update a trail's metadata by repo id](https://docs.entire.com/api-reference/trails/trails/update-a-trails-metadata-by-repo-id.md)</td></tr>
  </tbody>
</table>

### Approvals

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/approvals</td><td>[List a trail's recorded approval decisions (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-approvals/list-a-trails-recorded-approval-decisions-repo_id-addressing.md)</td></tr>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/approvals</td><td>[Submit an approval decision on a trail (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-approvals/submit-an-approval-decision-on-a-trail-repo_id-addressing.md)</td></tr>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/merge</td><td>[Merge a Trail (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-approvals/merge-a-trail-repo_id-addressing.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/mergeability</td><td>[Get merge readiness for a trail (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-approvals/get-merge-readiness-for-a-trail-repo_id-addressing.md)</td></tr>
  </tbody>
</table>

### Discussions

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions</td><td>[List a trail's discussions (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/list-a-trails-discussions-repo_id-addressing.md)</td></tr>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions</td><td>[Start a new discussion (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/start-a-new-discussion-repo_id-addressing.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions<wbr />/\{discussion\_id}</td><td>[Get a discussion and its messages (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/get-a-discussion-and-its-messages-repo_id-addressing.md)</td></tr>
    <tr><td>PATCH /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions<wbr />/\{discussion\_id}</td><td>[Update a discussion's title/resolved state (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/update-a-discussions-titleresolved-state-repo_id-addressing.md)</td></tr>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions<wbr />/\{discussion\_id}<wbr />/messages</td><td>[Add a message to a discussion (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/add-a-message-to-a-discussion-repo_id-addressing.md)</td></tr>
    <tr><td>DELETE /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions<wbr />/\{discussion\_id}<wbr />/messages<wbr />/\{message\_id}</td><td>[Delete a message (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/delete-a-message-repo_id-addressing.md)</td></tr>
    <tr><td>PATCH /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/discussions<wbr />/\{discussion\_id}<wbr />/messages<wbr />/\{message\_id}</td><td>[Edit a message (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-discussions/edit-a-message-repo_id-addressing.md)</td></tr>
  </tbody>
</table>

### Activity

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/events</td><td>[List or stream trail events (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-activity/list-or-stream-trail-events-repo_id-addressing.md)</td></tr>
  </tbody>
</table>

### Gates

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/gates</td><td>[Get the configurable gate evaluation for a trail (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-gates/get-the-configurable-gate-evaluation-for-a-trail-repo_id-addressing.md)</td></tr>
  </tbody>
</table>

### Reviews

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/reviews</td><td>[Start a code review (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-reviews/start-a-code-review-repo_id-addressing.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/reviews<wbr />/comments</td><td>[List all review comments for a trail (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-reviews/list-all-review-comments-for-a-trail-repo_id-addressing.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/reviews<wbr />/\{review\_id}</td><td>[Get review state (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-reviews/get-review-state-repo_id-addressing.md)</td></tr>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/reviews<wbr />/\{review\_id}<wbr />/comments</td><td>[Atomically publish review comments and summary (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-reviews/atomically-publish-review-comments-and-summary-repo_id-addressing.md)</td></tr>
    <tr><td>PATCH /repos<wbr />/\{repo\_id}<wbr />/trails<wbr />/\{number}<wbr />/reviews<wbr />/\{review\_id}<wbr />/comments<wbr />/\{comment\_id}</td><td>[Update a review comment (repo\_id addressing)](https://docs.entire.com/api-reference/trails/trail-reviews/update-a-review-comment-repo_id-addressing.md)</td></tr>
  </tbody>
</table>

## Sessions and checkpoints

### Your activity

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /me<wbr />/sessions</td><td>[Your sessions across all repositories](https://docs.entire.com/api-reference/sessions/me/your-sessions-across-all-repositories.md)</td></tr>
    <tr><td>GET /me<wbr />/trails</td><td>[Your trails across all repositories](https://docs.entire.com/api-reference/sessions/me/your-trails-across-all-repositories.md)</td></tr>
  </tbody>
</table>

### Checkpoints

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/checkpoints</td><td>[Checkpoints on a branch, with commit, diffstat, and sessions](https://docs.entire.com/api-reference/sessions/checkpoints/checkpoints-on-a-branch-with-commit-diffstat-and-sessions.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/checkpoints<wbr />/\{checkpoint\_id}</td><td>[A single checkpoint, with its branch membership](https://docs.entire.com/api-reference/sessions/checkpoints/a-single-checkpoint-with-its-branch-membership.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/checkpoints<wbr />/\{checkpoint\_id}<wbr />/transcript</td><td>[A checkpoint's sessions as message trees](https://docs.entire.com/api-reference/sessions/checkpoints/a-checkpoints-sessions-as-message-trees.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/checkpoints<wbr />/\{checkpoint\_id}<wbr />/transcript<wbr />/raw</td><td>[Stream a checkpoint session's raw transcript](https://docs.entire.com/api-reference/sessions/checkpoints/stream-a-checkpoint-sessions-raw-transcript.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/commits<wbr />/\{sha}<wbr />/checkpoints</td><td>[Checkpoints linked to a commit, with commit, diffstat, and sessions](https://docs.entire.com/api-reference/sessions/checkpoints/checkpoints-linked-to-a-commit-with-commit-diffstat-and-sessions.md)</td></tr>
  </tbody>
</table>

### Experts

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>POST /repos<wbr />/\{repo\_id}<wbr />/experts</td><td>[Rank the agents that worked on a repository's files or paths](https://docs.entire.com/api-reference/sessions/experts/rank-the-agents-that-worked-on-a-repositorys-files-or-paths.md)</td></tr>
  </tbody>
</table>

### Sessions

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead><tr><th scope="col">Endpoint</th><th scope="col">Reference</th></tr></thead>

  <tbody>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/sessions</td><td>[Sessions in a repository](https://docs.entire.com/api-reference/sessions/sessions/sessions-in-a-repository.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/sessions<wbr />/\{session\_id}</td><td>[A single session](https://docs.entire.com/api-reference/sessions/sessions/a-single-session.md)</td></tr>
    <tr><td>GET /repos<wbr />/\{repo\_id}<wbr />/sessions<wbr />/\{session\_id}<wbr />/transcript</td><td>[A session's full transcript as a message tree](https://docs.entire.com/api-reference/sessions/sessions/a-sessions-full-transcript-as-a-message-tree.md)</td></tr>
  </tbody>
</table>