Resources, integrations, and bindings API
Create and control tenant Resources, inspect contracts, and manage scoped Resource or Credential assignments.
Resources
| Method | Path | Purpose |
|---|---|---|
GET / POST | /v1/namespaces/:namespace/resources | List ?kind=... or create a configured Resource |
GET / DELETE | /v1/namespaces/:namespace/resources/:kind/:id | Read or delete a tenant-managed Resource |
GET | /v1/namespaces/:namespace/resources/:kind/:id/control | Read control head |
POST | /v1/namespaces/:namespace/resources/:kind/:id/enable | Enable with eventId and optional reason |
POST | /v1/namespaces/:namespace/resources/:kind/:id/disable | Disable with eventId and optional reason |
Platform catalog Resources are merged into list/read responses but tenants cannot mutate or delete them.
Resource contracts
| Method | Path | Purpose |
|---|---|---|
GET / POST | /v1/namespaces/:namespace/resource-contracts | List or publish an immutable Resource contract |
GET | /v1/namespaces/:namespace/resource-contracts/:id/:version?hash=... | Read one exact contract |
Resource contracts describe the operations, schemas, effects, and capabilities an integration must provide. Use the Console workflow for installing or configuring an integration rather than depending on implementation internals.
Scoped assignments
| Method | Path | Purpose |
|---|---|---|
GET / POST | /v1/namespaces/:namespace/bindings | List visible assignments or create one |
GET / DELETE | /v1/namespaces/:namespace/bindings/:id | Read or delete one assignment head |
POST | /v1/namespaces/:namespace/bindings/:id/promote | Promote to a new target when expectedHeadSeq still matches |
POST | /v1/namespaces/:namespace/bindings/:id/enable, /disable, /revoke | Apply an idempotent lifecycle control |
GET | /v1/namespaces/:namespace/integrations[/:id] | Read owner-filtered integration projections |
Creation and promotion declare the logical key, owner, target class, exact target CRN, optional contract, and event identity. Customer/principal callers can see only assignments within their accepted ownership boundary. See Scoped bindings for resolution semantics.