Save processing steps as a new configuration version for a workflow.
POST
/agents/{agent_id}/configs
Authorization
AuthorizationRequiredBearer <token>
In: header
Request Body
application/jsonRequiredstepsRequiredarray<object>
Processing steps. See Configure processing steps for settings by step type.
is_defaultboolean
Whether to use this version when an execution omits config_id.
Default:
truenamestring | null
A name for this configuration version.
Default:
nullPath Parameters
agent_idRequiredstring
The Workflow ID returned when the workflow was created.
Examples
Request
Response
Notes
Exactly one step must be first. Step names must be unique, and every next_steps[].step_name must refer to a step in this Config. Cycles are not allowed. See processing steps for each stepโs settings.
Input errors
| Error code | Cause |
|---|---|
config_steps_empty | No processing steps. |
config_first_step_invalid | Missing or multiple starting steps. |
config_step_name_duplicate | Duplicate step names. |
config_next_step_not_found | The next step does not exist. |
config_graph_cyclic | A cycle exists in the step connections. |
config_step_data_invalid | Invalid settings for the step type. |
These errors return HTTP 400 with error.param="steps". If present, error.details identifies the affected step.