---
title: "Registry API"
description: "The private agent registry for internal discovery."
label: "Registry"
generated: "the API catalogue in apps/control-plane/src/routes/developer.ts"
---


Scoped to your organization. It exists so teams can find each other’s agents, and publishing to it grants no authority whatsoever.

## Endpoints

| | Endpoint | Permission | Notes |
| --- | --- | --- | --- |
| `GET` | `/v1/registry` | `registry:read` | — |
| `POST` | `/v1/registry` | `registry:publish` | — |

## What each endpoint does

### `GET /v1/registry`

Search the private registry.

Requires `registry:read`.

### `POST /v1/registry`

Publish an agent to the private registry.

Requires `registry:publish`.