workflows

Update a workflow revision

put/v1/workflows/revisions/{revision_id}

Path parameters

revision_idstring uuid required

Request body

namestring nullable
descriptionstring nullable
instructionsstring nullable

Read-only after creation; supplying a value returns 422. Edit the graph instead.

compilation_strategy'fast' | 'standard' | 'strong'
trigger_type'auto' | 'keyword' | 'event' | 'manual' | 'always_on'
trigger_configobject nullable
router_config_idstring uuid nullable
policy_idsstring[] nullable

Response

Successful Response

idstring uuid required
workflow_idstring uuid required
namestring required
descriptionstring nullable
instructionsstring required
compiled_graphobject nullable
executable_graphobject nullable
quality_reportobject nullable
compilation_errorsstring[] nullable
compilation_strategystring required
compilation_statusstring required
compilation_task_idstring nullable
compilation_input_hashstring nullable
trigger_typestring required
trigger_configobject required
router_config_idstring uuid nullable
tool_input_defaultsobject nullable
knowledge_base_idsstring[]
created_bystring nullable
created_atstring date-time required
updated_atstring date-time required
graph_versioninteger
warningsstring[]

Changes

Changed in 1 of the 3 revisions of this API.42117

  • 5a5597ebb2d642117See the full diff
    • removed subschema #1 from the compilation_strategy request property anyOf list

      request-property-any-of-removed

    • removed subschema #1 from the trigger_type request property anyOf list

      request-property-any-of-removed

    • the response property tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/transfer_target/anyOf[subschema #1: TransferTargetView]/destination became optional for the status 200

      response-property-became-optional

    • response property tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/transfer_target/anyOf[subschema #1: TransferTargetView]/destination list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/request_timeout_ms/anyOf[subschema #1]/ request property's max was set to 20000.00

      request-property-max-set

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/temperature/anyOf[subschema #1]/ request property's max was set to 2.00

      request-property-max-set

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/top_p/anyOf[subschema #1]/ request property's max was set to 1.00

      request-property-max-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/request_timeout_ms/anyOf[subschema #1]/ request property's max was set to 20000.00

      request-property-max-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/temperature/anyOf[subschema #1]/ request property's max was set to 2.00

      request-property-max-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/top_p/anyOf[subschema #1]/ request property's max was set to 1.00

      request-property-max-set

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/max_tokens/anyOf[subschema #1]/ request property's min was set to 1.00

      request-property-min-set

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/request_timeout_ms/anyOf[subschema #1]/ request property's min was set to 1000.00

      request-property-min-set

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/temperature/anyOf[subschema #1]/ request property's min was set to 0.00

      request-property-min-set

    • the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/top_p/anyOf[subschema #1]/ request property's min was set to 0.00

      request-property-min-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/max_tokens/anyOf[subschema #1]/ request property's min was set to 1.00

      request-property-min-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/request_timeout_ms/anyOf[subschema #1]/ request property's min was set to 1000.00

      request-property-min-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/temperature/anyOf[subschema #1]/ request property's min was set to 0.00

      request-property-min-set

    • the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/top_p/anyOf[subschema #1]/ request property's min was set to 0.00

      request-property-min-set

    • removed the request property system_prompt

      request-property-removed

    • removed the optional property system_prompt from the response with the 200 status

      response-optional-property-removed

    • removed the optional property tools/items/tool_revision_id from the response with the 200 status

      response-optional-property-removed

    • added the new max enum value to the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

    • added the new max enum value to the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

    • added the new minimal enum value to the analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

    • added the new minimal enum value to the router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

    • added CompilationStrategy to the compilation_strategy request property anyOf list

      request-property-any-of-added

    • added TriggerType to the trigger_type request property anyOf list

      request-property-any-of-added

    • added the new max enum value to the request property analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/

      request-property-enum-value-added

    • added the new max enum value to the request property router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/

      request-property-enum-value-added

    • added the new minimal enum value to the request property analyzer_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/

      request-property-enum-value-added

    • added the new minimal enum value to the request property router_model_settings/anyOf[subschema #1: ModelChainEntry]/config/reasoning_effort/anyOf[subschema #1]/

      request-property-enum-value-added

    • added the optional property executable_graph to the response with the 200 status

      response-optional-property-added

    • added the optional property graph_version to the response with the 200 status

      response-optional-property-added

    • added the optional property retry_after to the response with the 400 status

      response-optional-property-added

    • added the optional property retry_after to the response with the 401 status

      response-optional-property-added

    • added the optional property retry_after to the response with the 404 status

      response-optional-property-added

    • added the optional property retryable to the response with the 400 status

      response-optional-property-added

    • added the optional property retryable to the response with the 401 status

      response-optional-property-added

    • added the optional property retryable to the response with the 404 status

      response-optional-property-added

    • added the optional property tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/compatibility to the response with the 200 status

      response-optional-property-added

    • added the optional property tools/items/tool/active_revision/anyOf[subschema #1: ToolRevisionResponse]/transfer_target/anyOf[subschema #1: TransferTargetView]/destination_source to the response with the 200 status

      response-optional-property-added

    • added the optional property warnings to the response with the 200 status

      response-optional-property-added

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog