Deployments and discovery API
Upload immutable executable packages, poll builds, and discover Agents, Channels, Auth Providers, providers, and Console catalog data.
Deploy executable packages
| 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
| 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. Tenant-managed integration implementations and contracts are covered by Resources and bindings. 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.