Connection point

Field reference for the connection point editor in the Agent Gateway dashboard, covering the Overview, Metadata, and Integrations tabs.

A connection point is the configuration entry that links this gateway to a remote gateway. It contains the invitation URL and secret shared with the remote gateway operator. Use this page to generate an OOB invitation for a remote gateway operator, view the connection secret, and check when the connection was last used.

For conceptual background, see Gateways. For step-by-step connection setup, see Connect two gateways.

Overview tab fields

SettingEditableDescription
Connection Point LinkNoThe out-of-band invitation URL. Share this with the operator of the remote gateway.
Connection SecretNoShared secret used to authenticate the invitation. Shown as a masked field; reveal it with the eye toggle and copy it using the copy button. If you lose it before sharing it with the remote operator, delete this connection point and create a new one.
Connection Point NameYesHuman-readable label for this connection.
DescriptionYesOptional description.
DID MethodNoThe DID method used to generate the identity for this connection point. Options: Web (did:web), WebVH (did:webvh), or Peer (did:peer). Defaults to Web (did:web). Set at creation and cannot be changed.
Last UsedNoWhen this connection point was last used. Displays as a relative time alongside the absolute timestamp. Shows Never used when the connection point has not been used yet.
Connection Point EnabledYesWhen disabled, the connection point stops accepting new DIDComm messages.
ExpiryNoVALID or EXPIRED badge based on the expiry date and time set at creation. Expired connection points cannot be imported by remote gateways.
UsesNoTotal number of times this connection point has been used.

Connection Health

Shows whether the remote gateway is currently reachable through this connection point. A failure here doesn’t affect other connection points or gateways.

The status badge is binary: CONNECTED or FAILED. There’s no separate “reconnecting” badge, a connection point that isn’t currently connected always shows FAILED while the gateway retries the link in the background. The retry schedule uses a fixed backoff that isn’t configurable from the dashboard.

Connection Health panel in the FAILED state, showing the failure reason, a reconnect countdown, the failed-attempts count, and the Retry Now button
FieldDescription
Status badgeCONNECTED or FAILED.
ReasonVisible only while the status is FAILED: a plain-language explanation of the failure, for example “Mediator is unreachable” or “Authentication with the mediator failed”.
Attempt to reconnect in ~N minAppears while the status is FAILED and an automatic retry is scheduled. Counts down to the next scheduled attempt.
Failed attemptsThe number of consecutive failed attempts since the connection was last healthy, while the status is FAILED.
Error detailsAn expandable disclosure, present only while the status is FAILED, holding the raw underlying error for diagnostics.
Last activeWhen the connection was last healthy. Shows Never connected if it has never connected.

Select Retry Now to retry the connection immediately instead of waiting for the next scheduled attempt. This clears the failed-attempt count and the scheduled retry, then restarts the connection.

Metadata tab fields

FieldDescription
Connection Point IDInternal identifier for this connection point.
Gateway IDThe gateway this connection point is associated with.
CreatedWhen the connection point was created.
Last UpdatedWhen the connection point record was last modified.
ExpiresWhen the invitation expires, if applicable. Shown only when an expiry is set. Expired invitations cannot be imported.
Mediator IDThe DIDComm mediator routing messages for this connection. Populated when a mediator is configured on the receiving gateway.

Mediator details

When a mediator is assigned, the Metadata tab also shows:

FieldDescription
Mediator NameDisplay name of the mediator.
DescriptionOptional description of the mediator.
DIDThe DID the mediator uses for DIDComm routing.

Integrations tab

Configure integrations that fire on this connection point’s own events, using category Connection Point. This is separate from a gateway’s own Integrations tab, which fires on gateway-level events instead. See Integrations reference for the field-level reference for each integration type and the runtime variables available here.

A Test Integrations button in the page header sends a test notification to every configured integration, using the current field values with any runtime variable references resolved to live data. Results are reported per integration in a modal. The button is disabled when no integrations are configured on this connection point.