---
title: "Discover and sync new candidate repositories from GitHub search."
method: POST
path: "/api/admin/discovery"
---

# Discover and sync new candidate repositories from GitHub search.

`POST /api/admin/discovery`

## Request

- Base URL: `https://git.top`
- URL: `https://git.top/api/admin/discovery`
- Auth: HTTP bearer

## Request body

- object
  - `max_candidates` integer: Maximum number of new candidates to sync in this run.
  - `search_index` integer: Optional deterministic index for the rotating discovery query.

## Response `200`

Candidate discovery result and recorded governance run

## Other responses

- `401`: Missing or invalid admin authorization
- `405`: Candidate discovery requires POST

---

[API](https://skmtc.dev/git/apis/git-top-agent-api.md) · [All operations](https://skmtc.dev/git/apis/git-top-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/git/apis/git-top-agent-api/revisions/c9ebf661ef6d?raw)