MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
Agents

Delete an agent version

Delete a saved version.

DELETE/agents//versions/
Path parameters
agent_idrequired
version_numberrequired
Query parameters
user_idinteger

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). 

curl -X DELETE 'https://omnidim.io/api/v1/agents/{agent_id}/versions/{version_number}' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example response
{
  "success": true,
  "message": "Version deleted successfully"
}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

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.

Query Parameters

user_id?integer

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.

Response body

application/json

Response Body

Version deleted.

application/json
success?boolean
message?string

Was this page helpful?

Rename an agent version

Rename a saved version or edit its note. Version history is immutable otherwise; only the name and note can change.

Diff an agent version

Get a record-level diff for this version. By default it shows what changed in this version compared with the version before it. Use `against=current` to compare with the agent's live config (what restoring this version would change), or `against=<number>` to compare with another version.