---
title: "Generate a picker token"
method: POST
path: "/connections/{connection_id}/picker-token"
tags: ["dataConnectors"]
---

# Generate a picker token

`POST /connections/{connection_id}/picker-token`

## Request

- Base URL: `https://api.twelvelabs.io/v1.3`
- URL: `https://api.twelvelabs.io/v1.3/connections/{connection_id}/picker-token`
- Auth: API key in header `x-api-key`

This method generates a short-lived, read-only access token that you use with the provider's file picker, such as the Google Drive Picker. The platform never returns the refresh token of the connection.

## Path parameters

- `connection_id` string, required

## Response `200`

The picker token has been successfully generated.

- DataConnectorsCreateConnectionPickerTokenResponse200
  - `access_token` string: A short-lived, read-only access token for use with the provider's file picker.
  - `expires_in` integer: The number of seconds until the token expires.
  - `scope` string: A space-delimited list of the scopes granted to the token.
  - `app_id` string: The Google Cloud project number, used with the Google Picker's `setAppId`. May be absent if the provider does not require this value for its picker.
  - `developer_key` string: A browser API key, used with the Google Picker's `setDeveloperKey`. May be absent if the provider does not require this value for its picker.

## Other responses

- `400`: The request has failed.
- `404`: The specified connection does not exist.
- `409`: The connection is not in an active state.

## Changes

- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `create-connection-picker-token` removed and replaced with `dataConnectors_create-connection-picker-token`
- **2026-07-31** `5dbd6e8473c9`: 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/connections/:connection_id/picker-token/post.md)

---

[API](https://skmtc.dev/twelvelabs/apis/twelvelabs-api.md) - [All operations](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/revisions/c23c6e18fdd1?raw)