Skip to main content
POST
Promote Agent to Production

Overview

Moves the agent’s production pointer to whatever staging is pinned to and records a deployment carrying that version’s original semver; promoting never mints a new number. Phone numbers attached to the agent begin answering with the promoted version. No request body. The server does not run checks here: start one with Start Check Run beforehand and gate on its result yourself. Requires an admin, owner, operator, or prompter role.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.

Response

string
The promoted version’s number, for example 1.4.0.
array
The agent’s three environments after the promote. Each has id, env_type (dev, staging, or production), and current_version_id (the pinned version, or null if unpinned). staging and production now point at the same version.
null | array
null on success, or a list of error objects if the request failed. Returns 400 STAGING_UNPINNED when nothing has been published to staging yet.

Docs for agents: llms.txt