v2

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

List semantic connector bindings

Lists semantic bindings for connector resources and fields. These bindings let the platform understand that an external field represents an employee email, SSN, customer id, supplier relationship, policy classification, or other semantic concept.

get/semantic/bindings

Query parameters

connectorTypestring

Extensible connector family identifier. This names the connector implementation or adapter family, not the transport, resource kind, or representation.

Example:http.openapi

Filters by extensible connector runtime family, for example http.openapi, sql.postgresql, identity.oidc, storage.vault, storage.blob, interaction.form, or internal.party-semantic-store. CSV remains a representation kind, not a connector type.

resourceKind'OBJECT' | 'TABULAR' | 'DOCUMENT' | 'CLAIM_SET' | 'GRAPH' | 'EVENT_STREAM' | 'FILE' | 'SECRET' | 'CONFIGURATION' | 'CREDENTIAL' | 'PRESENTATION' | 'CUSTOM'

Logical kind of resource being accessed, independent of transport and serialization. For example, a CSV file with rows is ResourceKind TABULAR and RepresentationKind CSV.

Example:TABULAR

Filters by logical resource kind. This does not imply a transport or serialization format.

pageinteger

Zero-based page index.

sizeinteger

Page size.

Response

Paged semantic connector bindings.

Example response

{
  "data": [
    {
      "semanticBindingId": "20392e94-3b35-4a77-afc2-5e552a0a4023",
      "resourceDescriptorId": "41436f49-040c-4f5f-9c7f-657f43762e2b",
      "fieldDescriptorId": "f00b9edc-5498-483f-9b91-a42ef080b909",
      "bindingKind": "ATTRIBUTE",
      "validationMode": "ENFORCE",
      "createdAt": "2026-06-18T09:30:00Z",
      "updatedAt": "2026-06-18T09:30:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "page": 0,
    "size": 20,
    "total": 1,
    "totalPages": 1,
    "hasMore": false
  }
}