Skip to main content

​
PATCH /api/v1/agents/:agentName

Renames an existing agent. The new name is slugified for the agent ID while preserving the display name.

​
Path Parameters

​
agentName
string
required
Current slug name of the agent to rename

​
Request Body

​
name
string
required
New display name for the agent. Will be slugified for the internal ID while preserving the full name for display.

​
Response

​
renamed
boolean
Always true on success
​
name
string
The new slugified agent name (internal ID)
​
display_name
string
The new display name (preserves original formatting)

​
Example

cURL
curl -X PATCH https://app.manifest.build/api/v1/agents/my-agent \
  -H "Content-Type: application/json" \
  -H "Cookie: session=..." \
  -d '{
    "name": "Production Agent"
  }'
Response
{
  "renamed": true,
  "name": "production-agent",
  "display_name": "Production Agent"
}

​
Error Responses

​
400 Bad Request
Agent name produces an empty slug or agent does not exist
​
401 Unauthorized
Missing or invalid session cookie
​
409 Conflict
An agent with the new name already exists for this tenant

​
Notes

  • The agent name is slugified (lowercased, spaces to hyphens, special characters removed)
  • The original display name is preserved for UI purposes
  • All existing messages, API keys, and routing configs remain associated with the agent
  • Renaming is an idempotent operation - renaming to the same name succeeds

​
See Also

List Agents

Get all agents with usage statistics

Delete Agent

Permanently delete an agent

Build docs developers (and LLMs) love

Get started for freeTalk to us