Skip to content

Skyvern: Agents schemas (part 2)

33 Skyvern schemas with complete fields and constraints.

← Agents operations · All schemas

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type terminate

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: terminate
Default: terminate
continue_on_failurebooleanOptionalDefault: false
error_codeJSONOptionalOptional error code added to the run's error codes; supports Jinja templating. A literal code must be at most 128 characters. The rendered code must be at most 128 characters and may contain only ASCII letters, digits, underscores, periods, colons, and hyphens.
error_code (anyOf 1)stringAlternative
error_code (anyOf 2)nullAlternative
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
reasonstringRequired within parentWhy the run ends here; supports Jinja templating.
Minimum length: 1

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type text prompt

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: text_prompt
Default: text_prompt
continue_on_failurebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
json_schemaJSONOptional
json_schema (anyOf 1)objectAlternativeAdditional keys: allowed
json_schema (anyOf 2)nullAlternative
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
llm_keyJSONOptional
llm_key (anyOf 1)stringAlternative
llm_key (anyOf 2)nullAlternative
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
parameter_keysJSONOptional
parameter_keys (anyOf 1)arrayAlternative
parameter_keys (anyOf 1)[]stringEach item
parameter_keys (anyOf 2)nullAlternative
promptstringRequired within parent

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type upload to s3

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: upload_to_s3
Default: upload_to_s3
continue_on_failurebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
pathJSONOptional
path (anyOf 1)stringAlternative
path (anyOf 2)nullAlternative

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type validation

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: validation
Default: validation
complete_criterionJSONOptional
complete_criterion (anyOf 1)stringAlternative
complete_criterion (anyOf 2)nullAlternative
continue_on_failurebooleanOptionalDefault: false
disable_cachebooleanOptionalDefault: false
engineJSONOptional
engine (anyOf 1)stringAlternativeOne of: skyvern-1.0, skyvern-2.0, skyvern-3.0, openai-cua, anthropic-cua, ui-tars, yutori-navigator
engine (anyOf 2)nullAlternative
engine_pinnedbooleanOptionalSet to true only when skyvern-1.0 was explicitly chosen for this block; leave it unset otherwise.
Default: false
error_code_mappingJSONOptional
error_code_mapping (anyOf 1)objectAlternativeAdditional keys: see wildcard field
error_code_mapping (anyOf 1).*stringAdditional keys
error_code_mapping (anyOf 2)nullAlternative
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
max_steps_per_runJSONOptional
max_steps_per_run (anyOf 1)integerAlternative
max_steps_per_run (anyOf 2)nullAlternative
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
parameter_keysJSONOptional
parameter_keys (anyOf 1)arrayAlternative
parameter_keys (anyOf 1)[]stringEach item
parameter_keys (anyOf 2)nullAlternative
terminate_criterionJSONOptional
terminate_criterion (anyOf 1)stringAlternative
terminate_criterion (anyOf 2)nullAlternative
without_page_informationbooleanOptionalDefault: false

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type wait

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: wait
Default: wait
continue_on_failurebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
wait_secintegerOptionalDefault: 0

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type web search, provider: auto, google, exa

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: web_search
Default: web_search
continue_on_failurebooleanOptionalDefault: false
error_code_mappingJSONOptional
error_code_mapping (anyOf 1)objectAlternativeAdditional keys: see wildcard field
error_code_mapping (anyOf 1).*stringAdditional keys
error_code_mapping (anyOf 2)nullAlternative
ignore_workflow_system_promptbooleanOptionalDefault: false
json_schemaJSONOptional
json_schema (anyOf 1)objectAlternativeAdditional keys: allowed
json_schema (anyOf 2)nullAlternative
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
no_match_error_codeJSONOptionalDeprecated. Use error_code_mapping.
no_match_error_code (anyOf 1)stringAlternativeMaximum length: 100
Minimum length: 1
no_match_error_code (anyOf 2)nullAlternative
no_results_error_codeJSONOptionalDeprecated. Use error_code_mapping.
no_results_error_code (anyOf 1)stringAlternativeMaximum length: 100
Minimum length: 1
no_results_error_code (anyOf 2)nullAlternative
num_resultsintegerOptionalDefault: 10
Maximum: 100.0
Minimum: 1.0
parameter_keysJSONOptional
parameter_keys (anyOf 1)arrayAlternative
parameter_keys (anyOf 1)[]stringEach item
parameter_keys (anyOf 2)nullAlternative
promptJSONOptional
prompt (anyOf 1)stringAlternative
prompt (anyOf 2)nullAlternative
providerstringOptionalDefault: auto
One of: auto, google, exa
querystringRequired within parentMinimum length: 1

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type while loop

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: while_loop
Default: while_loop
conditionModelRequired within parentExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type while loop condition
continue_on_failurebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
loop_blocksarrayRequired within parent
loop_blocks[]JSONEach item
loop_blocks[] (oneOf 1)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type task
loop_blocks[] (oneOf 2)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type for loop
loop_blocks[] (oneOf 3)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type while loop
loop_blocks[] (oneOf 4)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type code
loop_blocks[] (oneOf 5)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type text prompt
loop_blocks[] (oneOf 6)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type download to s3
loop_blocks[] (oneOf 7)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type upload to s3
loop_blocks[] (oneOf 8)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type file upload, storage type: s3, azure, google drive, sftp
loop_blocks[] (oneOf 9)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type send email, body format: text, html
loop_blocks[] (oneOf 10)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type file url parser, file type: auto detect, csv, excel, pdf, image, docx, zip
loop_blocks[] (oneOf 11)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type validation
loop_blocks[] (oneOf 12)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item ai fallback: fallback, proactive, block type action
loop_blocks[] (oneOf 13)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type navigation
loop_blocks[] (oneOf 14)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type extraction
loop_blocks[] (oneOf 15)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type login
loop_blocks[] (oneOf 16)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type wait
loop_blocks[] (oneOf 17)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type human interaction, body format: text, html
loop_blocks[] (oneOf 18)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type file download, download target: website, s3, azure, google drive, sftp
loop_blocks[] (oneOf 19)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type data export
loop_blocks[] (oneOf 20)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type terminate
loop_blocks[] (oneOf 21)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type agent step
loop_blocks[] (oneOf 22)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type goto url
loop_blocks[] (oneOf 23)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type pdf parser
loop_blocks[] (oneOf 24)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type task v2
loop_blocks[] (oneOf 25)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type http request
loop_blocks[] (oneOf 26)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type web search, provider: auto, google, exa
loop_blocks[] (oneOf 27)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type conditional
loop_blocks[] (oneOf 28)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type print page, format: A4, Letter, Legal, Tabloid
loop_blocks[] (oneOf 29)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type pdf fill
loop_blocks[] (oneOf 30)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type split pdf
loop_blocks[] (oneOf 31)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type workflow trigger
loop_blocks[] (oneOf 32)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type google sheets read
loop_blocks[] (oneOf 33)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type email inbox, email client: gmail, outlook
loop_blocks[] (oneOf 34)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type google sheets write, write mode: append, update
loop_blocks[] (oneOf 35)ModelAlternativeExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type powerbi query
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false

Referenced models: Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item ai fallback: fallback, proactive, block type action, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type agent step, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type while loop condition, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type code, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type conditional, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type data export, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type download to s3, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type email inbox, email client: gmail, outlook, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type extraction, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type file download, download target: website, s3, azure, google drive, sftp, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type file url parser, file type: auto detect, csv, excel, pdf, image, docx, zip, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type file upload, storage type: s3, azure, google drive, sftp, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type for loop, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type google sheets read, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type google sheets write, write mode: append, update, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type http request, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type human interaction, body format: text, html, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type login, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type navigation, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type pdf parser, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type pdf fill, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type powerbi query, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type print page, format: A4, Letter, Legal, Tabloid, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type send email, body format: text, html, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type split pdf, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type task, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type task v2, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type terminate, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type text prompt, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type upload to s3, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type goto url, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type validation, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type wait, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type web search, provider: auto, google, exa, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type while loop, Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type workflow trigger

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type while loop condition

FieldTypePresenceDescription and constraints
$objectRoot
criteria_typestringOptionalDefault: jinja2_template
One of: jinja2_template, prompt
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
expressionstringRequired within parent

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition blocks item block type workflow trigger

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: workflow_trigger
Default: workflow_trigger
browser_session_idJSONOptional
browser_session_id (anyOf 1)stringAlternative
browser_session_id (anyOf 2)nullAlternative
continue_on_failurebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier; must be unique per workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]].
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
parameter_keysJSONOptional
parameter_keys (anyOf 1)arrayAlternative
parameter_keys (anyOf 1)[]stringEach item
parameter_keys (anyOf 2)nullAlternative
payloadJSONOptional
payload (anyOf 1)objectAlternativeAdditional keys: allowed
payload (anyOf 2)nullAlternative
use_parent_browser_sessionbooleanOptionalDefault: false
wait_for_completionbooleanOptionalDefault: true
workflow_permanent_idstringRequired within parent

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type aws secret

FieldTypePresenceDescription and constraints
$objectRoot
aws_keystringRequired within parent
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: aws_secret
Default: aws_secret

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type azure vault credential

FieldTypePresenceDescription and constraints
$objectRoot
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: azure_vault_credential
Default: azure_vault_credential
password_keystringRequired within parent
totp_secret_keyJSONOptional
totp_secret_key (anyOf 1)stringAlternative
totp_secret_key (anyOf 2)nullAlternative
username_keystringRequired within parent
vault_namestringRequired within parent

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type bitwarden credit card data

FieldTypePresenceDescription and constraints
$objectRoot
bitwarden_client_id_aws_secret_keystringRequired within parent
bitwarden_client_secret_aws_secret_keystringRequired within parent
bitwarden_collection_idstringRequired within parent
bitwarden_item_idstringRequired within parent
bitwarden_master_password_aws_secret_keystringRequired within parent
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: bitwarden_credit_card_data
Default: bitwarden_credit_card_data

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type bitwarden login credential

FieldTypePresenceDescription and constraints
$objectRoot
bitwarden_client_id_aws_secret_keystringRequired within parent
bitwarden_client_secret_aws_secret_keystringRequired within parent
bitwarden_collection_idJSONOptional
bitwarden_collection_id (anyOf 1)stringAlternative
bitwarden_collection_id (anyOf 2)nullAlternative
bitwarden_item_idJSONOptional
bitwarden_item_id (anyOf 1)stringAlternative
bitwarden_item_id (anyOf 2)nullAlternative
bitwarden_master_password_aws_secret_keystringRequired within parent
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: bitwarden_login_credential
Default: bitwarden_login_credential
totp_identifierJSONOptional
totp_identifier (anyOf 1)stringAlternative
totp_identifier (anyOf 2)nullAlternative
url_parameter_keyJSONOptional
url_parameter_key (anyOf 1)stringAlternative
url_parameter_key (anyOf 2)nullAlternative

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type bitwarden sensitive information

FieldTypePresenceDescription and constraints
$objectRoot
bitwarden_client_id_aws_secret_keystringRequired within parent
bitwarden_client_secret_aws_secret_keystringRequired within parent
bitwarden_collection_idstringRequired within parent
bitwarden_identity_fieldsarrayRequired within parent
bitwarden_identity_fields[]stringEach item
bitwarden_identity_keystringRequired within parent
bitwarden_master_password_aws_secret_keystringRequired within parent
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: bitwarden_sensitive_information
Default: bitwarden_sensitive_information

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type context

FieldTypePresenceDescription and constraints
$objectRoot
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: context
Default: context
source_parameter_keystringRequired within parent

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type credential

FieldTypePresenceDescription and constraints
$objectRoot
credential_idstringRequired within parent
credential_idsJSONOptional
credential_ids (anyOf 1)arrayAlternative
credential_ids (anyOf 1)[]stringEach item
credential_ids (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
fallback_credential_idsJSONOptional
fallback_credential_ids (anyOf 1)arrayAlternative
fallback_credential_ids (anyOf 1)[]stringEach item
fallback_credential_ids (anyOf 2)nullAlternative
fallback_triggerJSONOptional
fallback_trigger (anyOf 1)stringAlternative
fallback_trigger (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: credential
Default: credential
selection_strategyJSONOptional
selection_strategy (anyOf 1)stringAlternative
selection_strategy (anyOf 2)nullAlternative

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type onepassword

FieldTypePresenceDescription and constraints
$objectRoot
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
item_idstringRequired within parent
keystringRequired within parent
parameter_typestringRequired within parentMust equal: onepassword
Default: onepassword
totp_field_nameJSONOptional
totp_field_name (anyOf 1)stringAlternative
totp_field_name (anyOf 2)nullAlternative
totp_identifierJSONOptional
totp_identifier (anyOf 1)stringAlternative
totp_identifier (anyOf 2)nullAlternative
vault_idstringRequired within parent

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type output

FieldTypePresenceDescription and constraints
$objectRoot
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: output
Default: output

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition parameters item parameter type workflow, workflow parameter type: string, integer, float, boolean, json, file url, credential id

FieldTypePresenceDescription and constraints
$objectRoot
default_valueJSONOptional
default_value (anyOf 1)stringAlternative
default_value (anyOf 2)integerAlternative
default_value (anyOf 3)numberAlternative
default_value (anyOf 4)booleanAlternative
default_value (anyOf 5)objectAlternativeAdditional keys: allowed
default_value (anyOf 6)arrayAlternative
default_value (anyOf 6)[]JSONEach item
default_value (anyOf 7)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
keystringRequired within parent
parameter_typestringRequired within parentMust equal: workflow
Default: workflow
workflow_parameter_typestringRequired within parentOne of: string, integer, float, boolean, json, file_url, credential_id

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition retry policy webhook on retry: final only, every attempt

FieldTypePresenceDescription and constraints
$objectRoot
delay_secondsintegerOptionalFixed delay before the next attempt, in seconds
Default: 0
Maximum: 3600.0
Minimum: 0.0
max_retriesintegerOptionalMaximum number of retries after the initial attempt
Default: 1
Maximum: 5.0
Minimum: 1.0
retry_onarrayRequired within parentTerminal status rules that enable retries
Minimum items: 1
retry_on[]ModelEach itemExpand Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition retry policy webhook on retry: final only, every attempt retry on item
webhook_on_retrystringOptionalWhether to send a webhook for every attempt or only the final attempt
Default: final_only
One of: final_only, every_attempt

Referenced models: Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition retry policy webhook on retry: final only, every attempt retry on item

Update an agent — request body — body / json_definition / status: published, draft, auto generated, importing, import failed workflow definition retry policy webhook on retry: final only, every attempt retry on item

FieldTypePresenceDescription and constraints
$objectRoot
error_codesJSONOptionalOptional error codes. The rule matches when any listed code is present.
error_codes (anyOf 1)arrayAlternative
error_codes (anyOf 1)[]stringEach itemMinimum length: 1
error_codes (anyOf 2)nullAlternative
statusstringRequired within parentTerminal status that triggers a retry rule; canceled is accepted for forward compatibility, but a canceled run never retries in the current runtime, including explicit API/UI cancels.
One of: completed, failed, terminated, canceled, timed_out

Update an agent — response body

FieldTypePresenceDescription and constraints
$objectRoot
adaptive_cachingbooleanOptionalDefault: false
agent_idstringRequired within parentAlias of `workflow_permanent_id` — the stable agent identifier (starts with `wpid_`).
Read only: true
ai_fallbackbooleanOptionalDefault: true
browser_profile_idJSONOptional
browser_profile_id (anyOf 1)stringAlternative
browser_profile_id (anyOf 2)nullAlternative
browser_profile_keyJSONOptional
browser_profile_key (anyOf 1)stringAlternative
browser_profile_key (anyOf 2)nullAlternative
browser_typeJSONOptional
browser_type (anyOf 1)stringAlternative
browser_type (anyOf 2)nullAlternative
build_sourceJSONOptionalWhich surface wrote this version: ui, copilot, mcp, cli, api, or internal. Null before tracking began.
build_source (anyOf 1)stringAlternativeWhich surface wrote a workflow version.

- ui: the Skyvern app
- copilot: the workflow copilot
- mcp: a first-party MCP client
- cli: the Skyvern CLI
- api: any other API or SDK caller
- internal: a workflow Skyvern creates for its own runs (task v2, login, credential tests)
Known values: ui, copilot, mcp, cli, api, internal
build_source (anyOf 2)nullAlternative
cache_keyJSONOptional
cache_key (anyOf 1)stringAlternative
cache_key (anyOf 2)nullAlternative
cdp_connect_headersJSONOptional
cdp_connect_headers (anyOf 1)objectAlternativeAdditional keys: see wildcard field
cdp_connect_headers (anyOf 1).*stringAdditional keys
cdp_connect_headers (anyOf 2)nullAlternative
code_versionJSONOptional
code_version (anyOf 1)JSONAlternative
code_version (anyOf 1) (anyOf 1)integerAlternative
code_version (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
code_version (anyOf 2)nullAlternative
copilot_authoredbooleanOptionalDefault: false
created_atstringRequired within parentFormat: date-time
created_byJSONOptional
created_by (anyOf 1)stringAlternative
created_by (anyOf 2)nullAlternative
deleted_atJSONOptional
deleted_at (anyOf 1)stringAlternativeFormat: date-time
deleted_at (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
edited_byJSONOptional
edited_by (anyOf 1)stringAlternative
edited_by (anyOf 2)nullAlternative
effective_default_engineJSONOptionalThe engine a task block with no `engine` set runs on in this agent, or null when engine routing decides it. Populated by the detail endpoint only.
effective_default_engine (anyOf 1)stringAlternativeKnown values: skyvern-1.0, skyvern-2.0, skyvern-3.0, openai-cua, anthropic-cua, ui-tars, yutori-navigator
effective_default_engine (anyOf 2)nullAlternative
enable_self_healingbooleanOptionalDefault: false
extra_http_headersJSONOptional
extra_http_headers (anyOf 1)objectAlternativeAdditional keys: see wildcard field
extra_http_headers (anyOf 1).*stringAdditional keys
extra_http_headers (anyOf 2)nullAlternative
folder_idJSONOptional
folder_id (anyOf 1)stringAlternative
folder_id (anyOf 2)nullAlternative
generate_script_on_terminalbooleanOptionalDefault: false
import_errorJSONOptional
import_error (anyOf 1)stringAlternative
import_error (anyOf 2)nullAlternative
is_saved_taskbooleanRequired within parent
is_templatebooleanOptionalDefault: false
mask_secretsbooleanOptionalDefault: false
max_elapsed_time_minutesJSONOptional
max_elapsed_time_minutes (anyOf 1)JSONAlternative
max_elapsed_time_minutes (anyOf 1) (anyOf 1)integerAlternative
max_elapsed_time_minutes (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
max_elapsed_time_minutes (anyOf 2)nullAlternative
max_screenshot_scrollsJSONOptional
max_screenshot_scrolls (anyOf 1)JSONAlternative
max_screenshot_scrolls (anyOf 1) (anyOf 1)integerAlternative
max_screenshot_scrolls (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
max_screenshot_scrolls (anyOf 2)nullAlternative
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
modified_atstringRequired within parentFormat: date-time
organization_idstringRequired within parent
original_created_atJSONOptionalWhen the agent's first version was created. Populated by the list endpoint only.
original_created_at (anyOf 1)stringAlternativeFormat: date-time
original_created_at (anyOf 2)nullAlternative
original_created_byJSONOptionalWho created the agent's first version. Populated by the list endpoint only.
original_created_by (anyOf 1)stringAlternative
original_created_by (anyOf 2)nullAlternative
persist_browser_sessionbooleanOptionalDefault: false
pin_saved_session_ipbooleanOptionalDefault: false
proxy_locationJSONOptional
proxy_location (anyOf 1)ModelAlternativeExpand Update an agent — response body — proxy location string
proxy_location (anyOf 2)ModelAlternativeExpand Update an agent — response body — proxy location city, country, is ISP, subdivision
proxy_location (anyOf 3)objectAlternativeAdditional keys: allowed
proxy_location (anyOf 4)nullAlternative
reuse_browser_sessionbooleanOptionalDefault: false
run_sequentiallyJSONOptional
run_sequentially (anyOf 1)booleanAlternative
run_sequentially (anyOf 2)nullAlternative
run_withstringOptionalDefault: agent
sequential_keyJSONOptional
sequential_key (anyOf 1)stringAlternative
sequential_key (anyOf 2)nullAlternative
statusstringOptionalKnown values: published, draft, auto_generated, importing, import_failed
Default: published
titlestringRequired within parent
totp_identifierJSONOptional
totp_identifier (anyOf 1)stringAlternative
totp_identifier (anyOf 2)nullAlternative
totp_verification_urlJSONOptional
totp_verification_url (anyOf 1)stringAlternative
totp_verification_url (anyOf 2)nullAlternative
versionJSONRequired within parent
version (anyOf 1)integerAlternative
version (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
webhook_callback_urlJSONOptional
webhook_callback_url (anyOf 1)stringAlternative
webhook_callback_url (anyOf 2)nullAlternative
workflow_definitionModelRequired within parentExpand Update an agent — response body — workflow definition
workflow_idstringRequired within parent
workflow_permanent_idstringRequired within parent

Referenced models: Update an agent — response body — proxy location city, country, is ISP, subdivision, Update an agent — response body — proxy location string, Update an agent — response body — workflow definition

Update an agent — response body — proxy location city, country, is ISP, subdivision

FieldTypePresenceDescription and constraints
$objectRootGranular proxy geo-targeting request with country, optional subdivision, and optional city.
cityJSONOptionalCity name in English from GeoNames (e.g., 'New York', 'Los Angeles', 'London')
city (anyOf 1)stringAlternativeMaximum length: 100
city (anyOf 2)nullAlternative
countrystringRequired within parentISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE')
Maximum length: 2
Minimum length: 2
isISPbooleanOptionalWhether this geo target is marked as an ISP proxy location.
Default: false
subdivisionJSONOptionalISO 3166-2 subdivision code without country prefix (e.g., 'CA' for California, 'NY' for New York)
subdivision (anyOf 1)stringAlternativeMaximum length: 10
subdivision (anyOf 2)nullAlternative

Update an agent — response body — proxy location string

FieldTypePresenceDescription and constraints
$stringRootKnown values: RESIDENTIAL, US-CA, US-NY, US-TX, US-FL, US-WA, RESIDENTIAL_ES, RESIDENTIAL_IE, RESIDENTIAL_GB, RESIDENTIAL_IN, RESIDENTIAL_JP, RESIDENTIAL_FR, RESIDENTIAL_DE, RESIDENTIAL_NZ, RESIDENTIAL_ZA, RESIDENTIAL_AR, RESIDENTIAL_AU, RESIDENTIAL_BR, RESIDENTIAL_TR, RESIDENTIAL_CA, RESIDENTIAL_MX, RESIDENTIAL_IT, RESIDENTIAL_NL, RESIDENTIAL_PH, RESIDENTIAL_KR, RESIDENTIAL_SA, RESIDENTIAL_ISP, NONE

Update an agent — response body — workflow definition

FieldTypePresenceDescription and constraints
$objectRoot
blocksarrayRequired within parent
blocks[]JSONEach item
blocks[] (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type conditional
blocks[] (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type for loop
blocks[] (anyOf 3)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type while loop
blocks[] (anyOf 4)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type task
blocks[] (anyOf 5)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type code
blocks[] (anyOf 6)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type text prompt
blocks[] (anyOf 7)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type download to s3
blocks[] (anyOf 8)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type upload to s3
blocks[] (anyOf 9)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type send_email, body_format: text, html
blocks[] (anyOf 10)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type file_url_parser, file_type: auto detect, csv, excel, pdf, image, docx, zip
blocks[] (anyOf 11)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type pdf parser
blocks[] (anyOf 12)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type validation
blocks[] (anyOf 13)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / ai_fallback: fallback, proactive, block type action
blocks[] (anyOf 14)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type navigation
blocks[] (anyOf 15)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type extraction
blocks[] (anyOf 16)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type login
blocks[] (anyOf 17)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type wait
blocks[] (anyOf 18)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type human_interaction, body_format: text, html
blocks[] (anyOf 19)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type file_download, download_target: website, s3, azure, google drive, sftp
blocks[] (anyOf 20)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type goto url
blocks[] (anyOf 21)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type task v2
blocks[] (anyOf 22)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type file_upload, storage_type: s3, azure, google drive, sftp
blocks[] (anyOf 23)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type http request
blocks[] (anyOf 24)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type web_search, provider: auto, google, exa
blocks[] (anyOf 25)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type print page
blocks[] (anyOf 26)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type workflow trigger
blocks[] (anyOf 27)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type google sheets read
blocks[] (anyOf 28)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type email_inbox, email_client: gmail, outlook
blocks[] (anyOf 29)ModelAlternativeExpand Update an agent — response body — workflow_definition / blocks / item / block_type google_sheets_write, write_mode: append, update
blocks[] (anyOf 30)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type powerbi query
blocks[] (anyOf 31)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type pdf fill
blocks[] (anyOf 32)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type split pdf
blocks[] (anyOf 33)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type data export
blocks[] (anyOf 34)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type terminate
blocks[] (anyOf 35)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type agent step
browser_settingsJSONOptionalSettings applied to every browser this workflow version creates.
browser_settings (anyOf 1)ModelAlternativeExpand Get a session — response body — browser settings timezone id
browser_settings (anyOf 2)nullAlternative
completion_contractJSONOptionalCopilot-managed: what a run of this workflow must produce, graded at run finalization. Derived from the request when a workflow is accepted; not intended to be authored by hand.
completion_contract (anyOf 1)objectAlternativeAdditional keys: allowed
completion_contract (anyOf 2)nullAlternative
error_code_mappingJSONOptional
error_code_mapping (anyOf 1)objectAlternativeAdditional keys: see wildcard field
error_code_mapping (anyOf 1).*stringAdditional keys
error_code_mapping (anyOf 2)nullAlternative
finally_block_labelJSONOptional
finally_block_label (anyOf 1)stringAlternative
finally_block_label (anyOf 2)nullAlternative
parametersarrayRequired within parent
parameters[]JSONEach item
parameters[] (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id
parameters[] (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type context
parameters[] (anyOf 3)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type aws secret
parameters[] (anyOf 4)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure secret
parameters[] (anyOf 5)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential
parameters[] (anyOf 6)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information
parameters[] (anyOf 7)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data
parameters[] (anyOf 8)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type onepassword
parameters[] (anyOf 9)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure vault credential
parameters[] (anyOf 10)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type output
parameters[] (anyOf 11)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type credential
retry_policyJSONOptionalOptional policy for retrying eligible terminal workflow runs
retry_policy (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow_definition / retry_policy / webhook_on_retry: final only, every attempt
retry_policy (anyOf 2)nullAlternative
versionJSONOptional
version (anyOf 1)integerAlternativeDefault: 1
version (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
workflow_system_promptJSONOptional
workflow_system_prompt (anyOf 1)stringAlternative
workflow_system_prompt (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — workflow definition parameters item parameter type aws secret, Update an agent — response body — workflow definition parameters item parameter type azure secret, Update an agent — response body — workflow definition parameters item parameter type azure vault credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data, Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information, Get a session — response body — browser settings timezone id, Update an agent — response body — workflow definition parameters item parameter type credential, Update an agent — response body — workflow definition blocks item block type download to s3, Update an agent — response body — workflow definition parameters item parameter type onepassword, Update an agent — response body — workflow_definition / blocks / item / ai_fallback: fallback, proactive, block type action, Update an agent — response body — workflow definition blocks item block type agent step, Update an agent — response body — workflow definition blocks item block type code, Update an agent — response body — workflow definition blocks item block type conditional, Update an agent — response body — workflow definition parameters item parameter type context, Update an agent — response body — workflow definition blocks item block type data export, Update an agent — response body — workflow_definition / blocks / item / block_type email_inbox, email_client: gmail, outlook, Update an agent — response body — workflow definition blocks item block type extraction, Update an agent — response body — workflow_definition / blocks / item / block_type file_download, download_target: website, s3, azure, google drive, sftp, Update an agent — response body — workflow_definition / blocks / item / block_type file_url_parser, file_type: auto detect, csv, excel, pdf, image, docx, zip, Update an agent — response body — workflow_definition / blocks / item / block_type file_upload, storage_type: s3, azure, google drive, sftp, Update an agent — response body — workflow definition blocks item block type for loop, Update an agent — response body — workflow definition blocks item block type google sheets read, Update an agent — response body — workflow_definition / blocks / item / block_type google_sheets_write, write_mode: append, update, Update an agent — response body — workflow definition blocks item block type http request, Update an agent — response body — workflow_definition / blocks / item / block_type human_interaction, body_format: text, html, Update an agent — response body — workflow definition blocks item block type login, Update an agent — response body — workflow definition blocks item block type navigation, Update an agent — response body — workflow definition parameters item parameter type output, Update an agent — response body — workflow definition blocks item block type pdf parser, Update an agent — response body — workflow definition blocks item block type pdf fill, Update an agent — response body — workflow definition blocks item block type powerbi query, Update an agent — response body — workflow definition blocks item block type print page, Update an agent — response body — workflow_definition / blocks / item / block_type send_email, body_format: text, html, Update an agent — response body — workflow definition blocks item block type split pdf, Update an agent — response body — workflow definition blocks item block type task, Update an agent — response body — workflow definition blocks item block type task v2, Update an agent — response body — workflow definition blocks item block type terminate, Update an agent — response body — workflow definition blocks item block type text prompt, Update an agent — response body — workflow definition blocks item block type upload to s3, Update an agent — response body — workflow definition blocks item block type goto url, Update an agent — response body — workflow definition blocks item block type validation, Update an agent — response body — workflow definition blocks item block type wait, Update an agent — response body — workflow_definition / blocks / item / block_type web_search, provider: auto, google, exa, Update an agent — response body — workflow definition blocks item block type while loop, Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id, Update an agent — response body — workflow_definition / retry_policy / webhook_on_retry: final only, every attempt, Update an agent — response body — workflow definition blocks item block type workflow trigger

Update an agent — response body — workflow definition blocks item block type agent step

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: agent_step
Default: agent_step
continue_on_failurebooleanOptionalDefault: false
data_schemaobjectRequired within parentAdditional keys: allowed
disable_cachebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier for a block; unique within a workflow.
max_turnsJSONOptional
max_turns (anyOf 1)integerAlternativeDefault: 25
max_turns (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
output_parameterModelRequired within parentExpand Update an agent — response body — workflow definition parameters item parameter type output
parametersarrayOptionalDefault: []
parameters[]JSONEach item
parameters[] (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id
parameters[] (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type context
parameters[] (anyOf 3)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type aws secret
parameters[] (anyOf 4)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure secret
parameters[] (anyOf 5)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential
parameters[] (anyOf 6)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information
parameters[] (anyOf 7)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data
parameters[] (anyOf 8)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type onepassword
parameters[] (anyOf 9)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure vault credential
parameters[] (anyOf 10)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type output
parameters[] (anyOf 11)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type credential
promptstringRequired within parent
toolsJSONOptional
tools (anyOf 1)arrayAlternative
tools (anyOf 1)[]stringEach item
tools (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — workflow definition parameters item parameter type aws secret, Update an agent — response body — workflow definition parameters item parameter type azure secret, Update an agent — response body — workflow definition parameters item parameter type azure vault credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data, Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information, Update an agent — response body — workflow definition parameters item parameter type credential, Update an agent — response body — workflow definition parameters item parameter type onepassword, Update an agent — response body — workflow definition parameters item parameter type context, Update an agent — response body — workflow definition parameters item parameter type output, Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id

Update an agent — response body — workflow definition blocks item block type code

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: code
Default: code
codestringRequired within parent
code_edited_by_handJSONOptional
code_edited_by_hand (anyOf 1)booleanAlternative
code_edited_by_hand (anyOf 2)nullAlternative
continue_on_failurebooleanOptionalDefault: false
data_schemaJSONOptional
data_schema (anyOf 1)objectAlternativeAdditional keys: allowed
data_schema (anyOf 2)arrayAlternative
data_schema (anyOf 2)[]JSONEach item
data_schema (anyOf 3)stringAlternative
data_schema (anyOf 4)nullAlternative
disable_cachebooleanOptionalDefault: false
error_code_mappingJSONOptional
error_code_mapping (anyOf 1)objectAlternativeAdditional keys: see wildcard field
error_code_mapping (anyOf 1).*stringAdditional keys
error_code_mapping (anyOf 2)nullAlternative
goal_needs_regenerationJSONOptional
goal_needs_regeneration (anyOf 1)booleanAlternative
goal_needs_regeneration (anyOf 2)nullAlternative
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier for a block; unique within a workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
output_parameterModelRequired within parentExpand Update an agent — response body — workflow definition parameters item parameter type output
parametersarrayOptionalDefault: []
parameters[]JSONEach item
parameters[] (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id
parameters[] (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type context
parameters[] (anyOf 3)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type aws secret
parameters[] (anyOf 4)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure secret
parameters[] (anyOf 5)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential
parameters[] (anyOf 6)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information
parameters[] (anyOf 7)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data
parameters[] (anyOf 8)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type onepassword
parameters[] (anyOf 9)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure vault credential
parameters[] (anyOf 10)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type output
parameters[] (anyOf 11)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type credential
promptJSONOptional
prompt (anyOf 1)stringAlternative
prompt (anyOf 2)nullAlternative
stepsJSONOptional
steps (anyOf 1)arrayAlternative
steps (anyOf 1)[]ModelEach itemExpand Update an agent — response body — workflow definition blocks item block type code steps array item
steps (anyOf 2)nullAlternative
user_owned_goalJSONOptional
user_owned_goal (anyOf 1)booleanAlternative
user_owned_goal (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — workflow definition parameters item parameter type aws secret, Update an agent — response body — workflow definition parameters item parameter type azure secret, Update an agent — response body — workflow definition parameters item parameter type azure vault credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data, Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information, Update an agent — response body — workflow definition parameters item parameter type credential, Update an agent — response body — workflow definition parameters item parameter type onepassword, Update an agent — response body — workflow definition blocks item block type code steps array item, Update an agent — response body — workflow definition parameters item parameter type context, Update an agent — response body — workflow definition parameters item parameter type output, Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id

Update an agent — response body — workflow definition blocks item block type code steps array item

FieldTypePresenceDescription and constraints
$objectRoot
action_typestringOptionalKnown values: click, input_text, paste_text, upload_file, download_file, select_option, checkbox, wait, hover, null_action, solve_captcha, terminate, complete, reload_page, close_page, new_tab, switch_tab, extract, verification_code, goto_url, go_back, go_forward, scroll, keypress, move, drag, left_mouse, execute_js
Default: null_action
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
line_endJSONOptional
line_end (anyOf 1)JSONAlternative
line_end (anyOf 1) (anyOf 1)integerAlternative
line_end (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
line_end (anyOf 2)nullAlternative
line_startJSONOptional
line_start (anyOf 1)JSONAlternative
line_start (anyOf 1) (anyOf 1)integerAlternative
line_start (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
line_start (anyOf 2)nullAlternative

Update an agent — response body — workflow definition blocks item block type conditional

FieldTypePresenceDescription and constraints
$objectRootBranching block that selects the next block label based on list-ordered conditions.
block_typestringRequired within parentMust equal: conditional
Default: conditional
branch_conditionsarrayOptional
branch_conditions[]ModelEach itemExpand Update an agent — response body — workflow definition blocks item block type conditional branch conditions item
continue_on_failurebooleanOptionalDefault: false
disable_cachebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier for a block; unique within a workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
output_parameterModelRequired within parentExpand Update an agent — response body — workflow definition parameters item parameter type output

Referenced models: Update an agent — response body — workflow definition blocks item block type conditional branch conditions item, Update an agent — response body — workflow definition parameters item parameter type output

Update an agent — response body — workflow definition blocks item block type conditional branch conditions item

FieldTypePresenceDescription and constraints
$objectRootRepresents a single conditional branch edge within a ConditionalBlock.
criteriaJSONOptional
criteria (anyOf 1)JSONAlternative
criteria (anyOf 1) (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type while loop condition criteria type jinja2 template
criteria (anyOf 1) (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition blocks item block type while loop condition criteria type prompt
criteria (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
idstringOptional
is_defaultbooleanOptionalDefault: false
next_block_labelJSONOptional
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — workflow definition blocks item block type while loop condition criteria type jinja2 template, Update an agent — response body — workflow definition blocks item block type while loop condition criteria type prompt

Update an agent — response body — workflow definition blocks item block type data export

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: data_export
Default: data_export
continue_on_failurebooleanOptionalDefault: false
datastringRequired within parent
data_schemaobjectRequired within parentAdditional keys: allowed
disable_cachebooleanOptionalDefault: false
file_nameJSONOptional
file_name (anyOf 1)stringAlternative
file_name (anyOf 2)nullAlternative
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier for a block; unique within a workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
output_parameterModelRequired within parentExpand Update an agent — response body — workflow definition parameters item parameter type output
parametersarrayOptionalDefault: []
parameters[]JSONEach item
parameters[] (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id
parameters[] (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type context
parameters[] (anyOf 3)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type aws secret
parameters[] (anyOf 4)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure secret
parameters[] (anyOf 5)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential
parameters[] (anyOf 6)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information
parameters[] (anyOf 7)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data
parameters[] (anyOf 8)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type onepassword
parameters[] (anyOf 9)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure vault credential
parameters[] (anyOf 10)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type output
parameters[] (anyOf 11)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type credential

Referenced models: Update an agent — response body — workflow definition parameters item parameter type aws secret, Update an agent — response body — workflow definition parameters item parameter type azure secret, Update an agent — response body — workflow definition parameters item parameter type azure vault credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data, Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information, Update an agent — response body — workflow definition parameters item parameter type credential, Update an agent — response body — workflow definition parameters item parameter type onepassword, Update an agent — response body — workflow definition parameters item parameter type context, Update an agent — response body — workflow definition parameters item parameter type output, Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id

Update an agent — response body — workflow definition blocks item block type download to s3

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: download_to_s3
Default: download_to_s3
continue_on_failurebooleanOptionalDefault: false
disable_cachebooleanOptionalDefault: false
ignore_workflow_system_promptbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier for a block; unique within a workflow.
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
output_parameterModelRequired within parentExpand Update an agent — response body — workflow definition parameters item parameter type output
urlstringRequired within parent

Referenced models: Update an agent — response body — workflow definition parameters item parameter type output

Update an agent — response body — workflow definition blocks item block type extraction

FieldTypePresenceDescription and constraints
$objectRoot
block_typestringRequired within parentMust equal: extraction
Default: extraction
complete_criterionJSONOptional
complete_criterion (anyOf 1)stringAlternative
complete_criterion (anyOf 2)nullAlternative
complete_criterion_is_untrustedbooleanOptionalDefault: false
complete_on_downloadbooleanOptionalDefault: false
complete_verificationbooleanOptionalDefault: true
continue_on_failurebooleanOptionalDefault: false
data_extraction_goalstringRequired within parent
data_schemaJSONOptional
data_schema (anyOf 1)objectAlternativeAdditional keys: allowed
data_schema (anyOf 2)arrayAlternative
data_schema (anyOf 2)[]JSONEach item
data_schema (anyOf 3)stringAlternative
data_schema (anyOf 4)nullAlternative
disable_cachebooleanOptionalDefault: false
download_suffixJSONOptional
download_suffix (anyOf 1)stringAlternative
download_suffix (anyOf 2)nullAlternative
download_timeoutJSONOptional
download_timeout (anyOf 1)JSONAlternative
download_timeout (anyOf 1) (anyOf 1)numberAlternative
download_timeout (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
download_timeout (anyOf 2)nullAlternative
engineJSONOptional
engine (anyOf 1)stringAlternativeKnown values: skyvern-1.0, skyvern-2.0, skyvern-3.0, openai-cua, anthropic-cua, ui-tars, yutori-navigator
engine (anyOf 2)nullAlternative
engine_pinnedbooleanOptionalDefault: false
error_code_mappingJSONOptional
error_code_mapping (anyOf 1)objectAlternativeAdditional keys: see wildcard field
error_code_mapping (anyOf 1).*stringAdditional keys
error_code_mapping (anyOf 2)nullAlternative
export_data_schemaJSONOptional
export_data_schema (anyOf 1)objectAlternativeAdditional keys: allowed
export_data_schema (anyOf 2)nullAlternative
export_enabledbooleanOptionalDefault: false
export_file_nameJSONOptional
export_file_name (anyOf 1)stringAlternative
export_file_name (anyOf 2)nullAlternative
export_recordsJSONOptional
export_records (anyOf 1)stringAlternative
export_records (anyOf 2)nullAlternative
ignore_workflow_system_promptbooleanOptionalDefault: false
include_action_history_in_verificationbooleanOptionalDefault: false
include_extracted_textbooleanOptionalDefault: false
labelstringRequired within parentAuthor-facing identifier for a block; unique within a workflow.
max_retriesJSONOptional
max_retries (anyOf 1)integerAlternativeDefault: 0
max_retries (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
max_steps_per_runJSONOptional
max_steps_per_run (anyOf 1)JSONAlternative
max_steps_per_run (anyOf 1) (anyOf 1)integerAlternative
max_steps_per_run (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
max_steps_per_run (anyOf 2)nullAlternative
modelJSONOptional
model (anyOf 1)objectAlternativeAdditional keys: allowed
model (anyOf 2)nullAlternative
navigation_goalJSONOptional
navigation_goal (anyOf 1)stringAlternative
navigation_goal (anyOf 2)nullAlternative
next_block_labelJSONOptionalOptional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
next_block_label (anyOf 1)stringAlternative
next_block_label (anyOf 2)nullAlternative
next_loop_on_failurebooleanOptionalDefault: false
output_parameterModelRequired within parentExpand Update an agent — response body — workflow definition parameters item parameter type output
parametersarrayOptionalDefault: []
parameters[]JSONEach item
parameters[] (anyOf 1)ModelAlternativeExpand Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id
parameters[] (anyOf 2)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type context
parameters[] (anyOf 3)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type aws secret
parameters[] (anyOf 4)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure secret
parameters[] (anyOf 5)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential
parameters[] (anyOf 6)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information
parameters[] (anyOf 7)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data
parameters[] (anyOf 8)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type onepassword
parameters[] (anyOf 9)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type azure vault credential
parameters[] (anyOf 10)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type output
parameters[] (anyOf 11)ModelAlternativeExpand Update an agent — response body — workflow definition parameters item parameter type credential
task_typestringOptionalDefault: general
terminate_criterionJSONOptional
terminate_criterion (anyOf 1)stringAlternative
terminate_criterion (anyOf 2)nullAlternative
titlestringOptionalDefault:
totp_identifierJSONOptional
totp_identifier (anyOf 1)stringAlternative
totp_identifier (anyOf 2)nullAlternative
totp_verification_urlJSONOptional
totp_verification_url (anyOf 1)stringAlternative
totp_verification_url (anyOf 2)nullAlternative
urlJSONOptional
url (anyOf 1)stringAlternative
url (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — workflow definition parameters item parameter type aws secret, Update an agent — response body — workflow definition parameters item parameter type azure secret, Update an agent — response body — workflow definition parameters item parameter type azure vault credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden credit card data, Update an agent — response body — workflow definition parameters item parameter type bitwarden login credential, Update an agent — response body — workflow definition parameters item parameter type bitwarden sensitive information, Update an agent — response body — workflow definition parameters item parameter type credential, Update an agent — response body — workflow definition parameters item parameter type onepassword, Update an agent — response body — workflow definition parameters item parameter type context, Update an agent — response body — workflow definition parameters item parameter type output, Update an agent — response body — workflow_definition / parameters / item / parameter_type workflow, workflow_parameter_type: string, integer, float, boolean, json, file url, credential id

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.