Sign in

v3

latestOpenAPI 3.1.0Proprietary2026-08-07266348629.6 KB
Agents

Rollback Agent Config

Roll a config-based agent back to a historical version.

Writes a new version N+1 whose config equals the target's stored snapshot, records change_kind='rollback' + rollback_source_version on the new history row, and redeploys the agent. Never a pointer swap, never destructive. If current validators reject the historical config (validator tightening between then and now), returns 422 with Pydantic's error text so the FE can highlight the offending fields.

post/agents/{job_id}/config/rollback

Path parameters

job_idstring required

Request body

targetVersioninteger required

The existing version number whose config will be copied into a new version. Version 0 is the initial change_kind='create' snapshot.

notestring nullable

Optional user-supplied context - recorded on the new rollback row.

Response

Successful Response

_idstring required
namestring required
job_type'pyflink' | 'jar' | 'agent_config' | 'knowledge_base' required
status'CREATED' | 'DEPLOYING' | 'RUNNING' | 'CANCELLING' | 'CANCELLED' | 'FAILED' | 'FINISHED' required
desired_status'CREATED' | 'DEPLOYING' | 'RUNNING' | 'CANCELLING' | 'CANCELLED' | 'FAILED' | 'FINISHED'
flink_job_namestring required
flink_job_idstring nullable
parallelisminteger
error_messagestring nullable
agent_configobject nullable
created_bystring nullable
created_timestampstring date-time nullable
updated_timestampstring date-time nullable