API ReferenceConnection

Create Connection

Creates a new connection.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired
connectionDetailsobjectRequired
metadatamap from strings to stringsRequired

Metadata information about the connection which is not relevant to the DB connection itself.

requiredTagNamesset of stringsRequired

Additional tag name that are required to construct a fully qualified series.

availableTagValuesmap from strings to sets of stringsRequired
shouldScrapebooleanRequired
descriptionstringOptional
scrapingobjectOptional
limitsobjectOptional
workspacestringOptional

The workspace in which to create the connection. If not provided, the connection will be created in the default workspace for the user’s organization, if the default workspace for the organization is configured.

Response

This endpoint returns an object.
ridstring
displayNamestring

The display name of the connection. For example: “Nominal production TimescaleDB”

connectionDetailsobject
requiredTagNamesset of strings

Additional tag names that should be supplied to construct a fully qualified series. These are suggested, rather than strictly required.

availableTagValuesmap from strings to sets of strings
metadatamap from strings to strings
shouldScrapeboolean

The connection will be scraped iff this flag is set and scrapingConfig is present.

connectionStatusobject
isArchivedboolean
descriptionstringOptional
scrapingobjectOptional
limitsobjectOptional