Agents
Save an agent version
Save the agent's current configuration as a named version.
POST/agents//versions
Bearersession
Path parameters
agent_idrequiredBody
3 fields
·
Reseller 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).
Display name for the version.
Optional note describing the version.
curl -X POST 'https://omnidim.io/api/v1/agents/{agent_id}/versions' \ -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." }'
Example response
{ "success": true, "version": { "id": 4830, "version_number": 6, "name": "Working pricing script", "note": "Before the new discount flow", "kind": "manual", "created_by": { "id": 1234, "name": "Demo User" }, "create_date": "2026-07-28T11:40: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 } } }
BearerAuthheader
AuthorizationBearer <token>Bearer token authentication. Obtain your API key from the OmniDimension dashboard.
agent_id*integerThe ID of the agent.
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*stringDisplay name for the version.
note?stringOptional note describing the version.
Response body
application/jsonVersion saved.
application/jsonsuccess?booleanversion?A saved snapshot of an agent's configuration.
Was this page helpful?