Doppler secretops

Learn how to use Doppler secretops with Composio

Overview

SLUG: DOPPLER_SECRETOPS

Description

Doppler is a secrets management platform that helps teams securely manage and sync environment variables across projects and environments.

Authentication Details

generic_api_key
stringRequired

Connecting to Doppler secretops

Create an auth config

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

1

Select App

Navigate to [Doppler secretops](https://platform.composio.dev?next_page=/marketplace/Doppler secretops).

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 secretops 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_secretops_auth_config_id = "ac_YOUR_DOPPLER_SECRETOPS_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 secretops 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_secretops_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 secretops toolkit’s playground](https://app.composio.dev/app/Doppler secretops)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["DOPPLER_SECRETOPS"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Activity Logs List

Description

Tool to list workplace activity logs. Use when you need to fetch recent activity logs.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Retrieve Activity Log

Description

Tool to retrieve a single activity log entry by id. Use when you have a valid Activity Log id.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve Config Log Entry

Description

Tool to retrieve a specific config log entry. Use when needing details of a single config log; call after specifying project, config, and log identifiers.

Action Parameters

config
stringRequired
log
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Config Logs List

Description

Tool to list config change logs for a specific config. Use when you need the audit trail for a config after confirming its identity.

Action Parameters

config
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 25
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Config Logs Rollback

Description

Tool to rollback a config to a selected log version. Use when needing to undo a specific change by its log ID, after confirming project, config, and log ID.

Action Parameters

config
stringRequired
log
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clone Config

Description

Tool to clone a branch config including all its secrets. Use after confirming the source config details.

Action Parameters

config
stringRequired
environment
stringRequired
name
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Branch Config

Description

Tool to create a branch config. Use when you need to programmatically establish a new branch-based configuration for a specified project and environment. Use after selecting the target project and environment.

Action Parameters

environment
stringRequired
name
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Configs Delete

Description

Tool to delete a config permanently. Use when you need to remove a config that is no longer needed.

Action Parameters

config
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Config Details

Description

Tool to fetch a config's details. Use when you need metadata for a specific config after specifying the project and config names. Example: "Get details for config 'staging-config' in project 'proj-123'."

Action Parameters

config
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lock Config

Description

Tool to lock a config. Use when you need to prevent a config from being renamed or deleted after confirming the project and config names. Example: "Lock config 'staging-config' in project 'proj-123' after finalizing environment setup."

Action Parameters

config
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unlock Config

Description

Tool to unlock a config. Use when you need to allow renaming or deletion of a previously locked config. Example: "Unlock config 'staging-config' in project 'proj-123'."

Action Parameters

config
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Config

Description

Tool to modify an existing config. Use when you need to rename a config after confirming project and config names.

Action Parameters

config
stringRequired
name
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Revoke Dynamic Secret Lease

Description

Tool to revoke a dynamic secret lease. Use when you need to invalidate an active lease by its ID after confirming the config and dynamic secret identifiers.

Action Parameters

config
stringRequired
dynamic_secret
stringRequired
lease
stringRequired
project
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Environment

Description

Tool to create a new environment. Use when you need to programmatically create an environment for a specified project.

Action Parameters

name
stringRequired
project
stringRequired
slug
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Environments Delete

Description

Tool to delete an environment. Use when you need to remove an environment from a project after confirming it's no longer in use.

Action Parameters

environment
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Environment Details

Description

Tool to retrieve an environment. Use when you need metadata for a specific environment after specifying the project and environment slug.

Action Parameters

environment
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Environments

Description

Tool to list environments in a Doppler project. Use when you need environment metadata for a specific project after providing the project slug.

Action Parameters

project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Rename Environment

Description

Tool to rename an environment. Use when you need to update an environment's display name after confirming project and environment identifiers.

Action Parameters

environment
stringRequired
name
stringRequired
project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove Group Member

Description

Tool to remove a member from a group. Use after confirming the group slug and member identifiers.

Action Parameters

member_slug
stringRequired
slug
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Integrations List

Description

Tool to list all external integrations. Use when you need to retrieve all configured external integrations after authentication.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Invites List

Description

Tool to list open workplace invites. Use when you need to retrieve all pending invitations for the current Doppler workplace after authenticating.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Remove Project Member

Description

Tool to remove a member from a project. Use after confirming project slug, member type, and slug. Example: "Delete member 'jdoe' of type 'users' from project 'my-project-slug'."

Action Parameters

project
stringRequired
slug
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Project Member

Description

Tool to retrieve a project member by type and slug. Use after confirming project slug, member type, and slug.

Action Parameters

project
stringRequired
slug
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Project Permissions List

Description

Tool to list project-level permissions. Use when you need to fetch all available permissions for projects after authentication.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Project Role

Description

Tool to retrieve a project role. Use when you need details of a specific project role after authenticating.

Action Parameters

role
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Project

Description

Tool to create a project. Use when you need to programmatically initialize a new Doppler project after authentication.

Action Parameters

description
string
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Projects Delete

Description

Tool to delete a project permanently. Use after confirming irreversible removal.

Action Parameters

project
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Projects

Description

Tool to list Doppler projects. Use when you need to retrieve all projects with optional pagination.

Action Parameters

page
integerDefaults to 1
per_page
integerDefaults to 25

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Secrets

Description

Tool to update secrets in a config. Use when you need to change secret values for deployments.

Action Parameters

config
stringRequired
project
stringRequired
secrets
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired