Sign in
dataConnectors

Retrieve a connection

This method retrieves details about the specified connection.

get/connections/{connection_id}

Path parameters

connection_idstring required

The unique identifier of the connection to retrieve.

Headers

x-api-keystring required

Your API key.

<Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>

Response

The connection has been successfully retrieved.

_idstring

The unique identifier of the connection.

provider'google_drive'

The data connector provider.

status'active' | 'expired' | 'revoked'

The status of the connection. See The connection object for the possible values.

custom_idstring

The label you supplied when you authorized the connection. The platform does not interpret this value, and it does not need to be unique. Multiple connections can share the same custom_id value.

scopesstring[]

The scopes granted to the connection.

connected_atstring date-time

The date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the connection was established.

last_used_atstring date-time

The date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the connection was last used.

Changes

Changed in 2 of the 11 revisions of this API.11