Skip to main content
POST
Create Agent Branch

Overview

Cuts a new branch from the agent’s newest dev version. Versions saved to the branch stay off the dev timeline until you land them with Merge Agent Branch. Use List Agent Branches to see what is open. 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.

Body Parameters

string
required
The branch name. Trimmed, then must be 1 to 64 characters using only letters, numbers, dots, underscores, and dashes. The names dev, latest, staging, and production (any casing) and anything shaped like a version number (for example 1.2.0) are reserved for version selectors. Any of these problems returns 400 INVALID_NAME with a message naming the rule. Returns 409 BRANCH_EXISTS when an open branch already has this name; names of merged or deleted branches can be reused.

Response

Returns 201 on success.
object
The new branch.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt