STstreamkap
Agents

Rollback Agent Config

Changed on

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 entry, and redeploys the agent. History is never rewritten or deleted. If the current validation rules reject the historical config (they have tightened since), returns 422 with the validation errors identifying the offending fields.

post/agents/{job_id}/config/rollback

Request

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

Changes