Skip to main content
POST
Create workflow

Authorizations

cc-key
string
header
required

API key-based authentication. Provide your CloudCruise API key in the cc-key header.

Headers

cc-key
string

CloudCruise API key for authentication

Body

application/json

Payload for creating a new workflow via POST. The workflow ID is generated server-side.

name
string
required

Display name of the workflow

nodes
object[]
required

Array of workflow step nodes

edges
object
required

Map of edges connecting workflow nodes

input_schema
object
required

JSON Schema defining the workflow's input variables

output_schema
object
required

JSON Schema defining the workflow's output variables

max_retries
integer
required

Maximum number of retry attempts for failed workflow steps

description
string | null

Optional description of the workflow

version_note
string

Optional note describing this version

use_native_actions
boolean | null

Whether to use native browser actions instead of simulated events

video_record_session
boolean | null

Whether to record a video of the workflow execution

extract_network_urls
string[] | null

URL patterns to extract from network traffic during execution

encrypted_keys
string[] | null

References to encrypted vault keys used by this workflow

popup_xpaths
string[] | null

XPath selectors for popups that should be automatically dismissed

vault_schema
object | null

Schema defining vault credentials required by this workflow

Example:
enable_popup_handling
boolean

Whether automatic popup handling is enabled

enable_action_timing_recovery
boolean

Whether action timing recovery is enabled

enable_xpath_recovery
boolean

Whether automatic XPath recovery is enabled

enable_node_description_enrichment
boolean

Whether node descriptions are auto-enriched for reliability improvements

enable_error_code_generation
boolean

Whether automatic error code generation is enabled

enable_service_unavailable_recovery
boolean

Whether service unavailable recovery is enabled

enable_incorrect_form_input_recovery
boolean

Whether incorrect form input recovery is enabled

enable_password_update_recovery
boolean

Whether password update recovery is enabled. When a site forces a password change, the Maintenance Agent classifies the error and sends a notification.

enable_tfa_setup_recovery
boolean

Whether automatic TFA setup recovery is enabled. When a site requires two-factor authentication setup during login, the Maintenance Agent can autonomously complete the enrollment and update the vault credential.

proxy_setting
string

Proxy configuration setting

proxy_value
string

Proxy value

enable_network_listener
boolean

Whether the network listener is enabled

skip_udp_proxying
boolean

Whether UDP proxying is skipped during workflow execution

Response

Workflow created successfully

Full workflow definition including nodes and edges

id
string<uuid>
required

Unique identifier for the workflow

name
string
required

Name of the workflow

created_at
string<date-time>
required

Timestamp when the workflow was created

updated_at
string<date-time>
required

Timestamp when the workflow was last updated

workspace_id
string<uuid>
required

ID of the workspace this workflow belongs to

created_by
string<uuid>
required

ID of the user who created the workflow

nodes
object[]
required

Array of workflow step nodes

edges
object
required

Map of edges connecting workflow nodes

description
string | null

Description of the workflow

version_number
integer

Current version number of the workflow

version_id
string<uuid>

ID of the current workflow version

input_schema
object | null

JSON schema defining the workflow's input variables

vault_schema
object | null

Schema defining vault credentials and their configuration

enable_popup_handling
boolean

Whether popup handling is enabled for this workflow

enable_xpath_recovery
boolean

Whether XPath recovery is enabled for this workflow

enable_node_description_enrichment
boolean

Whether node descriptions are auto-enriched for reliability improvements

enable_error_code_generation
boolean

Whether error code generation is enabled for this workflow

enable_service_unavailable_recovery
boolean

Whether service unavailable recovery is enabled for this workflow

enable_incorrect_form_input_recovery
boolean

Whether incorrect form input recovery is enabled

enable_password_update_recovery
boolean

Whether password update recovery is enabled. When a site forces a password change, the Maintenance Agent classifies the error and sends a notification.

enable_tfa_setup_recovery
boolean

Whether automatic TFA setup recovery is enabled. When a site requires two-factor authentication setup during login, the Maintenance Agent can autonomously complete the enrollment and update the vault credential.

enable_action_timing_recovery
boolean

Whether action timing recovery is enabled

origin_catalog_workflow_id
string<uuid> | null

ID of the catalog workflow this was forked from (if applicable)

origin_catalog_version_number
integer | null

Version number of the catalog workflow this was forked from

origin_catalog_workflow_version_id
string<uuid> | null

Specific origin catalog workflow version ID used as the base

origin_base_version_number
integer | null

Base version number used when deriving from a catalog workflow

track_updates_from_catalog
boolean

Whether to track updates from the origin catalog workflow

enable_network_listener
boolean

Whether network listener capture is enabled for this workflow version

skip_udp_proxying
boolean

Whether UDP proxying is skipped for this workflow version