v2

latestOpenAPI 3.0.4Apache 2.0raw.githubusercontent.com2026-07-1754198241.7 KB

LogicalConnectionBindings

Create a logical connection binding

Creates or replaces a logical connection binding for a physical connector instance. Use this resource to declare tenant, OU, brand, channel, caller, auth overlay, grant, governance, and system-catalog projection metadata without duplicating the physical connector registration.

post/logical/bindings

Request body

Example request

{
  "binding": {
    "logicalConnectionBindingId": "brand-a-proof-vault",
    "physicalConnectorInstanceId": "8a7f09af-7ac9-4d96-91f9-a2a252f4aa4b",
    "logicalContext": {
      "tenantId": "acme",
      "organizationUnitId": "nl-ops",
      "brandId": "brand-a"
    }
  }
}

Response

Logical connection binding created.

logicalConnectionBindingIdstring required

Stable identifier of a tenant, OU, brand, legal-entity, or channel usage binding for a physical connector instance.

physicalConnectorInstanceIdstring uuid required

Stable platform identifier for a configured connector instance.

allowedOperationsOperationKind[]

Example response

{
  "logicalConnectionBindingId": "brand-a-proof-vault",
  "physicalConnectorInstanceId": "8a7f09af-7ac9-4d96-91f9-a2a252f4aa4b",
  "logicalContext": {
    "tenantId": "acme",
    "organizationUnitId": "nl-ops",
    "brandId": "brand-a"
  },
  "authOverlay": {
    "mode": "TENANT_SECRET_REF",
    "secretRef": "vault://tenant/acme/connectors/proof-vault"
  },
  "allowedOperations": [
    "READ",
    "WRITE"
  ]
}