Connector operators

Public

The Connector family contains 4 operators. Outbound calls to third-party services (auth-gated by secret refs).

Operators in this family

Executes an action on a connected external service.

Version 1.0.0 · Semantics side_effect · Visibility advanced

Field	Type	Required	Default
`action`	string	yes	—
`connector_id`	string	yes	—
`params`	object	no	—

Port	Type	Required	Description
`input`	any	no	Input

Port	Type	Required	Description
`output`	any	no	Output

Calls a third-party API through a tenant-scoped connector credential (OAuth2, API key, basic, bearer).

Version 1.0.0 · Semantics side_effect

Field	Type	Required	Default	Description
`connector_id`	string	yes	—	ID of the connector credential to use (looked up in glyph.connector_credentials).
`request`	object	yes	—	HTTP request to send. Either ‘url’ or ‘path’ (joined to credential.base_url) is required.

Port	Type	Required	Description
`input`	any	no	Input

Port	Type	Required	Description
`output`	object	no	Output

Lists resources of a given kind from a connector (e.g. customers, charges). Dispatched by connector_kind to per-kind handlers.

Version 1.0.0 · Semantics side_effect · Idempotent

Field	Type	Required	Default	Description
`connector_id`	string	yes	—	ID of the connector credential to use.
`page`	integer	no	`1`
`resource_kind`	string	yes	—	Kind of resource to list (e.g. ‘customers’, ‘accounts’).

Port	Type	Required	Description
`input`	any	no	Input

Port	Type	Required	Description
`output`	object	no	Output

Searches a connected external service.

Version 1.0.0 · Semantics side_effect · Visibility advanced

Field	Type	Required	Default	Description
`connector_id`	string	yes	—
`query_template`	string	no	—

Port	Type	Required	Description
`query`	string	yes	Query

Port	Type	Required	Description
`results`	array	no	Results

Every operator above is rendered from its JSON schema in /opt/glyph/schemas/operators/: