Managing Prompt Updates in Production: Environment Tags and Webhook Alerts
Last updated: January 12, 2026
Prerequisites
Plans: Any
Deployments: Any
Use case
Using Braintrust as a central prompt registry for production workflows, enabling developers to save prompts in Braintrust and automatically make them available in external systems, with environment-based deployment controls and update notifications.
Features used
Environment Tags: Tags (production, staging, development, etc.) allow you to associate prompt versions with specific environments and promote prompts through your deployment pipeline in a controlled manner.
Environment Update Alerts: Webhook based alerts that trigger when environment tags are added or removed from prompts, providing a user-initiated workflow for syncing prompt updates to external systems.
Steps
Step 1: Configure environment tags for prompt deployment
Environment tags allow you to promote prompt versions through your deployment pipeline (e.g., development → staging → production).
To add an environment tag to a prompt:
Navigate to your prompt in the Braintrust UI
Click the dropdown button in the top right of the prompt view
Select or create an environment tag (production, staging, development, etc.)
The tag is now associated with the current prompt version
Step 2: Set up environment update alerts for webhook notifications
This webhook will fire a payload to your URL whenever the configured environment tag is added to or removed from a prompt. This provides a controlled, user-initiated workflow for syncing prompt updates.
To configure an environment update alert:
Click Settings on the left-hand navigation bar of your project
Click Alerts on the left-hand side of the Settings page
Click the + Alert button in the top right
Enter an Alert name (e.g., "Production Prompt Update")
Select "Environment update" as the Event Type
Select either "All environments" or specify the specific environment tag (e.g., "production")
Select "Webhook URL" as the Action type
Enter your webhook endpoint URL
Click Create alert
Step 3: Handle webhook payloads and sync prompts
When your webhook endpoint receives an environment update notification, call the /v1/prompt API endpoint to fetch the latest prompt version and update your external system.
Alternatively you can leverage the loadPrompts function (see below documentation) in our SDK to pin the prompt usage in your application code to a specific version or environment tag, with that setup you can possibly bypass the webhook configuration all together and just rely on the environment tag to dictate what prompt version is live in each environment.