Authorizations
Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however internal consumers must provide a JWT id_token issued by our IdP.
Path Parameters
ID is the unique identifier of the Connector.
Body
ConnectorUpdate is the input to the UpdateConnector endpoint.
HTTPConnectorUpdate is the input to the UpdateHTTPConnector endpoint. Connections cannot be updated via the
UpdateHTTPConnector endpoint. To update an Connection, use the UpdateConnection
endpoint.
ConnectorUpdateBase provides the common fields to update any Connector type. Attempts to mutate a field marked
Versions cannot be updated via this endpoint.
ID is the unique identifier of the Connector.
OrganisationID is the unique identifier of the Organisation that owns the Connector.
Name is the user-provided name of the Connector
ProtocolType denotes the set of all valid connector types.
Title | Const |
---|---|
http |
BaseURL is the base URL of all HTTP Actions within the Connector.
AuthSchemeConfigIDs allows reordering the AuthSchemeConfigs for the Connector. This field cannot be used to
create/edit/delete individual AuthSchemeConfigs, for those use cases, see the API endpoints at
/o/:organisationId/connectors/:connectorId/auth-scheme-configs[/:id]
. If this field is omitted then the
AuthSchemeConfigs are not edited.
Hold an optional link to the documentation for the API.
The URL for the icon for the connector
ConnectionVariables, if set, will overwrite the existing list of connection variables or create new ones with the provided array. This action will be performed on all the connector connections as well.
Response
OK
Connector represents a connector to an external system. HTTPConnector represents a connector to an external system over HTTP. ConnectorBase holds common fields which exist across all Connector protocols.
ID is the unique identifier of the Connector.
OrganisationID is the unique identifier of the Organisation that owns the Connector.
Name is the user-provided name of the Connector
ProtocolType denotes the set of all valid connector types.
Title | Const |
---|---|
http |
Connections is a list of all the connections this Connector has.
Versions is a list of all the versions this Connector has.
CreatedAt is the time at which the ConnectorVersion was created.
UpdatedAt is the time at which the ConnectorVersion was last updated, including any changes to child resources.
BaseURL is the base URL of all HTTP Actions within the Connector.
Hold an optional link to the documentation for the API.
The URL for the icon for the connector
Connection Variables is a list of default variables initialised in every connector connection.