List the caller's readable repositories (placement index)

curl --request GET \
  --url https://us.console.entire.io/api/v1/repos \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://us.console.entire.io/api/v1/repos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://us.console.entire.io/api/v1/repos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://us.console.entire.io/api/v1/repos"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://us.console.entire.io/api/v1/repos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "candidatesIncomplete": true,
  "repos": [
    {
      "cell": "<string>",
      "clusterSlug": "<string>",
      "full_name": "<string>",
      "id": "<string>",
      "jurisdiction": "<string>",
      "name": "<string>",
      "org": "<string>",
      "placements": [
        {
          "cell": "<string>",
          "clusterSlug": "<string>",
          "id": "<string>",
          "jurisdiction": "<string>",
          "mirror": true,
          "status": "processing",
          "apiBaseUrl": "<string>"
        }
      ],
      "provider": "github",
      "repoGroupId": "<string>",
      "visibility": "<string>",
      "activityHotness": 123,
      "archived": true,
      "candidate": {
        "access": "read",
        "onboardable": true
      },
      "checkpointCount": 123,
      "forks": 123,
      "language": "<string>",
      "lastActivityAt": "2023-11-07T05:31:56Z",
      "lastPushedAt": "2023-11-07T05:31:56Z",
      "openPrCount": 123,
      "permission": "read",
      "primaries": {
        "data_primary": {
          "forge": "<string>",
          "repo_id": "<string>"
        },
        "git_data": "<string>",
        "processing": "<string>",
        "processing_primary": {
          "forge": "<string>",
          "repo_id": "<string>"
        }
      },
      "pushedAt": "2023-11-07T05:31:56Z",
      "stars": 123
    }
  ],
  "truncated": true,
  "$schema": "/api/v1/schemas/ListReposOutputBody.json",
  "nextPageToken": "<string>"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

GET

repos

List the caller's readable repositories (placement index)

curl --request GET \
  --url https://us.console.entire.io/api/v1/repos \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://us.console.entire.io/api/v1/repos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://us.console.entire.io/api/v1/repos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://us.console.entire.io/api/v1/repos"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://us.console.entire.io/api/v1/repos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "candidatesIncomplete": true,
  "repos": [
    {
      "cell": "<string>",
      "clusterSlug": "<string>",
      "full_name": "<string>",
      "id": "<string>",
      "jurisdiction": "<string>",
      "name": "<string>",
      "org": "<string>",
      "placements": [
        {
          "cell": "<string>",
          "clusterSlug": "<string>",
          "id": "<string>",
          "jurisdiction": "<string>",
          "mirror": true,
          "status": "processing",
          "apiBaseUrl": "<string>"
        }
      ],
      "provider": "github",
      "repoGroupId": "<string>",
      "visibility": "<string>",
      "activityHotness": 123,
      "archived": true,
      "candidate": {
        "access": "read",
        "onboardable": true
      },
      "checkpointCount": 123,
      "forks": 123,
      "language": "<string>",
      "lastActivityAt": "2023-11-07T05:31:56Z",
      "lastPushedAt": "2023-11-07T05:31:56Z",
      "openPrCount": 123,
      "permission": "read",
      "primaries": {
        "data_primary": {
          "forge": "<string>",
          "repo_id": "<string>"
        },
        "git_data": "<string>",
        "processing": "<string>",
        "processing_primary": {
          "forge": "<string>",
          "repo_id": "<string>"
        }
      },
      "pushedAt": "2023-11-07T05:31:56Z",
      "stars": 123
    }
  ],
  "truncated": true,
  "$schema": "/api/v1/schemas/ListReposOutputBody.json",
  "nextPageToken": "<string>"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

Authorizations

Authorization

string

header

required

Authorization code flow with PKCE-S256. RFC 8628 device flow is also supported.

Query Parameters

pageSize

integer<int32>

Maximum entries to return; server may cap further.

Required range: 0 <= x <= 500

pageToken

string

Opaque cursor from a previous response's nextPageToken.

scope

enum<string>

default:onboarded

onboarded (default): repos in Entire; all: also include onboardable GitHub candidates.

Available options:

onboarded,

all

filter

string

Optional: up to 100 comma-separated names: gh/owner/repo (GitHub only), et/project/repo (Entire-native only), or legacy owner/repo (both namespaces). Exact matching is case-insensitive; deduplication includes the forge. Unknown prefixes or malformed names return 400. Returns authorized onboarded repos with consolidated placements. Missing repos are omitted. Pagination, scope, and sorting are ignored; fact filters and projectId still apply. A single name remains supported.

commitToken

string

Optional: opaque commit token from a create, to read a snapshot that contains that write. Requires a single filter name. A non-empty token with multiple supplied names returns 400, including duplicate names.

Pattern: ^$|^[A-Za-z0-9_-]{60,512}$

sort

string

Multi-key sort spec, e.g. org:asc,stars:desc. Keys: name,org,language,candidacy,stars,forks,pushed_at,last_activity_at,last_pushed_at,activity_hotness,checkpoint_count,open_pr_count. A single bare key uses the order param. Encoded into the cursor (authoritative on continuation).

order

enum<string>

Direction for a single bare sort key; defaults to asc. Ignored when sort carries per-key :asc/:desc suffixes. Encoded into the cursor (authoritative on continuation).

Available options:

asc,

desc

language

string

Exact-match repo_facts.language. Also accepts language[eq]/language[ne] (bare is sugar for [eq]).

visibility

enum<string>

Filter on the observed repo_facts.private fact (public: private=false; private: private=true). Also accepts visibility[eq]/visibility[ne].

Available options:

public,

private

archived

enum<string>

Filter on repo_facts.archived.

Available options:

true,

false

hasCheckpoints

enum<string>

true: repo_facts.checkpoint_count > 0; false: no checkpoints (0 or unobserved).

Available options:

true,

false

org

string

Exact-match owner/project org (case-insensitive). Also accepts org[eq]/org[ne].

string

Literal case-insensitive substring match on the full name (owner/repo).

projectId

string

Exact-match owning project id (ULID). Also accepts projectId[eq]; projectId[ne] is rejected.

Pattern: ^$|^[0-9A-HJKMNP-TV-Z]{26}$

status

enum<string>

Filter on placement/candidacy lifecycle. inactive requires scope=all. Also accepts status[eq]/status[ne].

Available options:

mirrored,

processing,

inactive

permission

enum<string>

Minimum caller access tier: read (all), write (write+admin), or admin. Also accepts permission[eq]; permission[ne] is rejected.

Available options:

read,

write,

admin

Response

candidatesIncomplete

boolean

required

repos

object[]

required

Show child attributes

truncated

boolean

required

$schema

string<uri>

read-only

A URL to the JSON Schema for this object.

Example:

"/api/v1/schemas/ListReposOutputBody.json"

nextPageToken

string

Pass back to fetch the next page; empty when no more entries.

Documentation

Accounts and projects

Git

Trails

Sessions and checkpoints

Webhooks

List the caller's readable repositories (placement index)

Authorizations

Query Parameters

Response