Update a workflow

POST

/v1/workflows/:workflow_id

POST

/v1/workflows/:workflow_id

1 from skyvern import Skyvern
2 
3 updated_workflow_definition = {
4     "title": "Updated Contact Forms Workflow",
5     "description": "Fill the contact form on the website",
6     "proxy_location": "RESIDENTIAL",
7     "webhook_callback_url": "https://example.com/webhook",
8     "totp_verification_url": "https://example.com/totp",
9     "totp_identifier": "4155555555",
10     "model": {"name": "gpt-4.1"},
11     "workflow_definition": {
12         "parameters": [
13             {
14                 "key": "website_url",
15                 "description": None,
16                 "parameter_type": "workflow",
17                 "workflow_parameter_type": "string",
18                 "default_value": None,
19             },
20             {
21                 "key": "name",
22                 "description": None,
23                 "parameter_type": "workflow",
24                 "workflow_parameter_type": "string",
25                 "default_value": None,
26             },
27             {
28                 "key": "additional_information",
29                 "description": None,
30                 "parameter_type": "workflow",
31                 "workflow_parameter_type": "string",
32                 "default_value": "Message: I'd love to learn more about your...
33 Phone: 123-456-7890
34 Inquiry type: sales
35 Optional Subject: Hello from [Company Here]",
36             },
37             {
38                 "key": "email",
39                 "description": None,
40                 "parameter_type": "workflow",
41                 "workflow_parameter_type": "string",
42                 "default_value": None,
43             },
44         ],
45         "blocks": [
46             {
47                 "label": "Fill_Out_Contact_Form",
48                 "continue_on_failure": True,
49                 "block_type": "navigation",
50                 "url": "{{website_url}}",
51                 "title": "Fill_Out_Contact_Form",
52                 "engine": "skyvern-1.0",
53                 "navigation_goal": "Find the contact form. Fill out the contact us form and submit it. Your goal is complete when the page says your message has been sent. In the case you can't find a contact us form, terminate.
54 
55 Fill out required fields as best you can using the following information:
56 {{name}}
57 {{email}}
58 {{additional_information}}",
59                 "error_code_mapping": None,
60                 "max_retries": 0,
61                 "max_steps_per_run": None,
62                 "complete_on_download": False,
63                 "download_suffix": None,
64                 "parameter_keys": [],
65                 "totp_identifier": None,
66                 "totp_verification_url": None,
67                 "complete_criterion": "",
68                 "terminate_criterion": "",
69                 "include_action_history_in_verification": False,
70             },
71             {
72                 "label": "Extract_Email",
73                 "continue_on_failure": False,
74                 "block_type": "extraction",
75                 "url": "",
76                 "title": "Extract_Email",
77                 "data_extraction_goal": "Extract a company email if available ",
78                 "data_schema": None,
79                 "max_retries": 0,
80                 "max_steps_per_run": None,
81                 "parameter_keys": [],
82             },
83         ],
84     },
85 }
86 skyvern = Skyvern(api_key="YOUR_API_KEY")
87 workflow = await skyvern.update_workflow(workflow_id="wpid_123", json_definition=updated_workflow_definition)
88 print(workflow)

Try it

200Successful

1 {
2   "workflow_id": "string",
3   "organization_id": "string",
4   "title": "string",
5   "workflow_permanent_id": "string",
6   "version": 1,
7   "is_saved_task": true,
8   "workflow_definition": {
9     "parameters": [
10       {
11         "parameter_type": "workflow",
12         "key": "string",
13         "description": "string",
14         "workflow_parameter_id": "string",
15         "workflow_parameter_type": "string",
16         "workflow_id": "string",
17         "default_value": {},
18         "created_at": "2024-01-15T09:30:00Z",
19         "modified_at": "2024-01-15T09:30:00Z",
20         "deleted_at": "2024-01-15T09:30:00Z"
21       }
22     ],
23     "blocks": [
24       {
25         "label": "string",
26         "next_block_label": "string",
27         "block_type": "conditional",
28         "output_parameter": {
29           "parameter_type": "output",
30           "key": "string",
31           "description": "string",
32           "output_parameter_id": "string",
33           "workflow_id": "string",
34           "created_at": "2024-01-15T09:30:00Z",
35           "modified_at": "2024-01-15T09:30:00Z",
36           "deleted_at": "2024-01-15T09:30:00Z"
37         },
38         "continue_on_failure": false,
39         "model": {},
40         "disable_cache": false,
41         "branch_conditions": [
42           {
43             "criteria": {
44               "criteria_type": "string",
45               "expression": "string",
46               "description": "string"
47             },
48             "next_block_label": "string",
49             "description": "string",
50             "is_default": false
51           }
52         ]
53       }
54     ],
55     "version": 1
56   },
57   "created_at": "2024-01-15T09:30:00Z",
58   "modified_at": "2024-01-15T09:30:00Z",
59   "description": "string",
60   "proxy_location": {},
61   "webhook_callback_url": "string",
62   "totp_verification_url": "string",
63   "totp_identifier": "string",
64   "persist_browser_session": false,
65   "model": {},
66   "status": "published",
67   "max_screenshot_scrolls": 1,
68   "extra_http_headers": {},
69   "run_with": "string",
70   "ai_fallback": false,
71   "cache_key": "string",
72   "run_sequentially": true,
73   "sequential_key": "string",
74   "folder_id": "string",
75   "import_error": "string",
76   "deleted_at": "2024-01-15T09:30:00Z"
77 }

Update a workflow

Path parameters

workflow_idstringRequired

The ID of the workflow to update. Workflow ID starts with wpid_.

Request

This endpoint expects an object.

json_definitionobject or nullOptional

Workflow definition in JSON format

yaml_definitionstring or nullOptional

Workflow definition in YAML format

Response

Successfully updated workflow

workflow_idstring

organization_idstring

titlestring

workflow_permanent_idstring

versioninteger

is_saved_taskboolean

workflow_definitionobject

created_atstringformat: "date-time"

modified_atstringformat: "date-time"

descriptionstring or null

proxy_locationenum or object or map from strings to any or null

webhook_callback_urlstring or null

totp_verification_urlstring or null

totp_identifierstring or null

persist_browser_sessionboolean or nullDefaults to false

modelmap from strings to any or null

statusenum or null

Allowed values:

max_screenshot_scrollsinteger or null

extra_http_headersmap from strings to strings or null

run_withstring or null

ai_fallbackboolean or nullDefaults to false

cache_keystring or null

run_sequentiallyboolean or null

sequential_keystring or null

folder_idstring or null

import_errorstring or null

deleted_atstring or nullformat: "date-time"

Update a workflow

Path parameters

Headers

Request

Response

Errors