Doppler

Learn how to use Doppler with Composio

Overview

SLUG: DOPPLER

Description

Doppler is a secrets management platform that helps developers organize and sync environment variables across teams and infrastructure.

Authentication Details

generic_api_key
stringRequired

Connecting to Doppler

Create an auth config

Use the dashboard to create an auth config for the Doppler toolkit. This allows you to connect multiple Doppler accounts to Composio for agents to use.

1

Select App

Navigate to Doppler.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Doppler Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4doppler_auth_config_id = "ac_YOUR_DOPPLER_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Doppler for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, doppler_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Doppler toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Get Authenticated User Info

Description

Tool to retrieve information about the authenticated user or token. Use when you need to verify authentication status or get details about the current token's workplace and permissions.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Config Log

Description

Tool to retrieve a specific config log from Doppler. Use when you need to view details about a particular configuration change or event.

Action Parameters

config
stringRequired
log
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Config Logs

Description

Tool to retrieve configuration change logs for a specific config in a project. Use when you need to view the history of configuration changes, track who made changes, or identify rollback actions.

Action Parameters

config
stringRequired
page
per_page
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Config

Description

Tool to retrieve a specific Doppler config by project and config name. Use when you need to get configuration details for a specific project environment.

Action Parameters

config
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Doppler Configs

Description

Tool to list configurations from a Doppler project. Use when you need to retrieve all configs or filter by environment. Supports pagination for large result sets.

Action Parameters

environment
page
Defaults to 1
per_page
Defaults to 20
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Encrypted Share Link

Description

Tool to generate a Doppler Share link by sending an encrypted secret. Use when you need to securely share secrets with end-to-end encryption. The receive flow is end-to-end encrypted where the encrypted secret will be decrypted on the recipient's browser.

Action Parameters

encrypted_secret
stringRequired
encryption_kdf
stringRequired
encryption_salt_rounds
integerRequired
expire_days
expire_views
hashed_password
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Plain Text Share Link

Description

Tool to generate a Doppler Share link by sending a plain text secret. Use when you need to securely share secrets with expiration controls. The secret is not stored in plain text by Doppler; the receive flow is end-to-end encrypted where the encrypted secret is decrypted in the browser.

Action Parameters

expire_days
expire_views
secret
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Environments

Description

Tool to list all environments in a Doppler project. Use when you need to retrieve the environments available in a specific project.

Action Parameters

project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Integrations

Description

Tool to retrieve all existing integrations in Doppler. Use when you need to list all configured integrations.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Change Requests

Description

Tool to list existing change requests in the Doppler workplace. Use when you need to retrieve all change requests and their current status.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Project Role

Description

Tool to retrieve details of a specific project role in Doppler. Use when you need to get information about a role's permissions and metadata.

Action Parameters

role
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Project Roles

Description

Tool to list all available project roles in Doppler. Use when you need to retrieve all roles for permission management or to see what roles are available.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Project Role Permissions

Description

Tool to list all available permissions for project roles in Doppler. Use when you need to see what permissions can be assigned to custom project roles.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Project Details

Description

Tool to retrieve details of a specific Doppler project by its identifier. Use when you need to get project metadata including name, description, and creation timestamp.

Action Parameters

project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Doppler Projects

Description

Tool to list all Doppler projects in your workspace. Use when you need to retrieve available projects for configuration management or to get project details.

Action Parameters

page
Defaults to 1
per_page
Defaults to 20

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Secret

Description

Tool to delete a secret from a Doppler config. Use when you need to permanently remove a secret from a specific project and config.

Action Parameters

config
stringRequired
name
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Download Secrets

Description

Tool to download secrets from a Doppler config in various formats. Use when you need to retrieve all secrets or a subset of secrets from a specific project and config. Supports multiple output formats and name transformations.

Action Parameters

config
dynamic_secrets_ttl_sec
format
Defaults to json
include_dynamic_secrets
name_transformer
project
secrets

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Secret

Description

Tool to retrieve a specific secret from a Doppler project config. Use when you need to get the value of a specific secret including its raw and computed values.

Action Parameters

config
stringRequired
name
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Doppler Secrets

Description

Tool to list all secrets for a specific Doppler config within a project. Use when you need to retrieve secret values and metadata. Returns both raw and computed values for each secret, along with visibility settings and optional notes.

Action Parameters

config
stringRequired
dynamic_secrets_ttl_sec
include_dynamic_secrets
include_managed_secrets
project
stringRequired
secrets

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Secret Names

Description

Tool to retrieve the list of secret names from a specific Doppler config. Use when you need to list available secret names without their values.

Action Parameters

config
stringRequired
include_dynamic_secrets
include_managed_secrets
Defaults to True
project
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Doppler Secrets

Description

Tool to update secrets in a Doppler config. Use when you need to create or update secret values in a specific project and config.

Action Parameters

config
stringRequired
project
stringRequired
secrets

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Secret Note

Description

Tool to update a note for a secret in Doppler. Use when you need to add or modify documentation for a specific secret. The note will be applied to the specified secret across all environments in the project.

Action Parameters

note
stringRequired
project
secret
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Workplace Information

Description

Tool to retrieve workplace information from Doppler. Use when you need to get workplace details including ID, name, billing email, and security email.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Workplace Role

Description

Tool to retrieve workplace role information from Doppler. Use when you need to get details about a specific role including its permissions and metadata.

Action Parameters

role
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Workplace Roles

Description

Tool to list all workplace roles in your Doppler workspace. Use when you need to retrieve available workplace roles for user management or permission configuration.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Workplace Permissions

Description

Tool to retrieve all available workplace permissions in Doppler. Use when you need to view the list of permissions that can be assigned to workplace roles.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired