Skip to main content

ConnectionEvent

A lifecycle event for a realized connection between two instances in an environment.

A connection is the runtime materialization of a blueprint link — it wires one instance's output artifact into another instance's input field within a single environment. Emitted when a connection is established or torn down. Subscribe via environmentEvents for every connection in an environment, or via instanceEvents for connections that terminate on a specific instance.

type ConnectionEvent implements Event {
action: EventAction!
timestamp: DateTime!
connection: Connection!
}

Fields

ConnectionEvent.action ● EventAction! non-null enum {#action}

ConnectionEvent.timestamp ● DateTime! non-null scalar {#timestamp}

ConnectionEvent.connection ● Connection! non-null object {#connection}

The connection that was created or deleted.

Interfaces

Event interface

Base interface implemented by all lifecycle events.

Every event carries an action describing what happened and a timestamp recording when it occurred. Concrete event types add a field for the affected resource.

Use inline fragments to access the resource-specific fields:

subscription {
projectEvents(organizationId: "my-org", projectId: "my-project") {
action
timestamp
... on ComponentEvent {
component { id name }
}
... on LinkEvent {
link { id fromField toField }
}
}
}