# Resources, integrations, and bindings API

> Create and control tenant Resources, inspect contracts, and manage scoped Resource or Credential assignments.

## Resources {#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 {#implementations}

| 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 {#bindings}

| 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](/docs/credentials/scoped-bindings) for resolution semantics.