# Deployments and discovery API

> Upload immutable executable packages, poll builds, and discover Agents, Channels, Auth Providers, providers, and Console catalog data.

## Deploy executable packages {#deploy}

| Method | Path | Authority | Purpose |
| --- | --- | --- | --- |
| `POST` | `/v1/deployments` | `deployment:create` | Upload a raw ZIP or tar.gz package |
| `GET` | `/v1/deployments/:deploymentId` | `deployment:read` | Read build, probe, publication, or failure state |

The upload content type is `application/zip` or `application/gzip`. Supply Bearer deployment authority and a stable `Idempotency-Key`. The root contains exactly one accepted manifest plus `package.json` and imported TypeScript source. Credential Provider packages also contain their root configuration schema. A successful result pins deployment revision, executable artifact, code digest, compatibility evidence, and registry publication.

## Discover deployed definitions {#discovery}

| Method | Path | Purpose |
| --- | --- | --- |
| `GET` | `/v1/namespaces/:namespace/agents` | List deployed Agents |
| `GET` | `/v1/namespaces/:namespace/agents/:agent` | Read one Agent identity and accepted configuration |
| `GET` | `/v1/namespaces/:namespace/channels` | List deployed Channels |
| `GET` | `/v1/namespaces/:namespace/channels/:channel` | Read one Channel |
| `GET` | `/v1/namespaces/:namespace/console/catalog` | Retrieve the Console’s authorized combined catalog projection |
| `GET` | `/v1/health` | Read public service health |

Credential Provider package discovery and installation are covered by [Credential HTTP API](/docs/credentials/reference/http-api). Tenant-managed integration implementations and contracts are covered by [Resources and bindings](/docs/api/resources-and-bindings.md). Git repository deployment is a Console workflow that resolves a public repository at an exact commit and submits its bounded archive through the same builder path.