> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

# The connection object

> Connection object schema for data connectors.

A connection represents an authorized link to a user's Google Drive account. After a user grants access, you use the connection to import the files they select into the platform as assets.

The [List connections](/v1.3/api-reference/data-connectors/list-connections) and [Retrieve a connection](/v1.3/api-reference/data-connectors/retrieve-a-connection) endpoints return connection objects. The platform never returns the access or refresh tokens of the connection.

# Connection fields

A connection object has the following fields:

* `_id`: The unique identifier of the connection. Use this value to retrieve the connection, generate a picker token, import files, or disconnect the account.
* `provider`: The data connector provider (`google_drive`).
* `status`: The status of the connection. See the [Connection statuses](#connection-statuses) section for details.
* `custom_id`: The label you supplied when creating the connection. Present only if you supplied one.
* `account`: Information about the connected provider account:
  * `external_id`: The identifier of the account at the provider. It does not change.
  * `display_name`: A human-readable label for the account, such as an email address.
* `scopes`: The access scopes granted to the connection.
* `connected_at`: The date and time, in the RFC 3339 format, when the connection was established.
* `last_used_at`: The date and time, in the RFC 3339 format, when the connection was last used.

# Connection statuses

The `status` field of a connection object has one of the following values:

* `active`: The connection is authorized and ready to use.
* `expired`: The authorization is no longer valid. Ask the user to reconnect the account.
* `revoked`: The user or the provider revoked access. Ask the user to reconnect the account.

When a connection is not `active`, requests that use it, such as generating a picker token or importing files, fail with the `connection_not_active` error. Reconnect the account to restore access.