CONNECTOR SDK REFERENCE2 of 10

Connector Capabilities

Capabilities declare exactly what your connector supports: resources, operations, events and features.

Declare your capabilities clearly and precisely

Capabilities are part of your connector manifest and returned by getCapabilities(). Keep them accurate and up to date.

Enables dynamic discovery of what you support

Prevents unsupported operations at runtime

Improves UX in Mediloop Console

Drives correct routing and transformations

Capabilities overview

Resources

Resource types your connector can read, search, create or update.

Operations

Supported operations per resource.

Events

Event types you can publish or subscribe to.

Protocol & features

Transport, auth, pagination, search, batching and cache.

Scopes required

Mediloop scopes needed to use each capability.

Capability metadata

Versioning, limitations, quotas and notes.

Example: getCapabilities() response

jsonCopy

{
  "connectorId": "acme-ehr",
  "version": "1.4.0",
  "resources": [
    { "type": "Patient", "operations": ["read","search","create","update"], "supportsIncludes": true },
    { "type": "Observation", "operations": ["read","search"] }
  ],
  "events": { "subscribe": ["patient.created","observation.updated"] }
}

Capabilities details

ResourcesList of FHIR or domain resources supported

Operationsread, search, create, update, delete

EventsEvents connector can publish or subscribe to

WorkflowsCustom actions or workflows

Protocol & featuresHTTPS, OAuth2, pagination, bulk

Scopes requiredScopes required for each capability

MetadataVersion, limits, deprecations, notes

DiscoverygetCapabilities() at runtime

Example: capability matrix

Resource	create	update	delete
Patient			—
Observation	—	—	—
Encounter			—
MedicationRequest			—
DocumentReference

How Mediloop uses your capabilities

1. Discovery

Mediloop calls getCapabilities()

2. Validation

Requests checked against capabilities

3. Routing

Operations routed to correct connector

4. UX & Console

Console shows only supported actions

5. Governance

Capabilities logged for audit