Agents
Rename an agent version
Rename a saved version or edit its note. Version history is immutable otherwise; only the name and note can change.
PATCH/agents//versions/
Bearersession
Path parameters
agent_idrequiredversion_numberrequiredBody
2 fields
·
New display name for the version.
New note for the version.
curl -X PATCH 'https://backend.omnidim.io/api/v1/agents/{agent_id}/versions/{version_number}' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{}'
Example response
{ "success": true, "version": { "id": 4821, "version_number": 5, "name": "Pre-launch pricing", "note": "Reviewed with the team", "kind": "manual", "created_by": { "id": 1234, "name": "Demo User" }, "create_date": "2026-07-20T10:15:00Z", "summary": { "llm_service": "gpt-4.1-mini", "voice_name": "asteria", "bot_type": "prompt", "languages": [ "English" ], "context_sections": 7, "transfer_options": 1, "post_call_configs": 1, "knowledge_files": 2, "integrations": 0, "flow_nodes": 0 } } }
Authorization
BearerAuth AuthorizationBearer <token>
Bearer token authentication. Obtain your API key from the OmniDimension dashboard.
In: header
Path Parameters
agent_id*integer
The ID of the agent.
version_number*integer
The version number, as returned in version_number from the list or save endpoints.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json