Rename an agent version
Rename a saved version or edit its note. Version history is immutable otherwise; only the name and note can change.
agent_idrequiredversion_numberrequiredReseller keys only: act as one of your clients by its user id. Omit it to act on your own account. [How acting for a client works](/docs/reseller/your-clients/acting-as-clients).
New display name for the version.
curl -X PATCH 'https://omnidim.io/api/v1/agents/{agent_id}/versions/{version_number}' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "user_id": 1234, "name": "v2 pricing script", "note": "Shorter opener, new objection handling." }'
{ "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 } } }
BearerAuthAuthorizationBearer <token>Bearer token authentication. Obtain your API key from the OmniDimension dashboard.
agent_id*integerThe ID of the agent.
version_number*integerThe version number, as returned in version_number from the list or save endpoints.
application/jsonuser_id?ClientUserIdReseller keys only: act as one of your clients by its user id. Omit it to act on your own account. How acting for a client works.
name?stringNew display name for the version.
note?stringNew note for the version.
Response body
application/jsonVersion renamed.
application/jsonsuccess?booleanversion?A saved snapshot of an agent's configuration.
Was this page helpful?