---
title: "Get an agent by id"
method: GET
path: "/v1/agents/{workflow_permanent_id}"
tags: ["Agents"]
---

# Get an agent by id

`GET /v1/agents/{workflow_permanent_id}`

## Path parameters

- `workflow_permanent_id` string, required

## Query parameters

- `version` integer, nullable
- `template` boolean

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Response `200`

Successful Response

- Workflow
  - `workflow_id` string, required
  - `organization_id` string, required
  - `title` string, required
  - `workflow_permanent_id` string, required
  - `version` integer, required
  - `is_saved_task` boolean, required
  - `is_template` boolean
  - `description` string, nullable
  - `workflow_definition` WorkflowDefinition, required
    - `version` integer
    - `parameters` union[], required
      - union
        - WorkflowParameter
          - `parameter_type` 'workflow'
          - `key` string, required
          - `description` string, nullable
          - `workflow_parameter_id` string, required
          - `workflow_parameter_type` 'string' | 'integer' | 'float' | 'boolean' | 'json' | 'file_url' | 'credential_id', required
          - `workflow_id` string, required
          - `default_value` union
            - string
            - integer
            - number
            - boolean
            - object
            - unknown[]
              - …
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - ContextParameter
          - `parameter_type` 'context'
          - `key` string, required
          - `description` string, nullable
          - `source` union, required
            - WorkflowParameter
              - …
            - ContextParameter — recursive
            - AWSSecretParameter
              - …
            - AzureSecretParameter
              - …
            - BitwardenLoginCredentialParameter
              - …
            - BitwardenSensitiveInformationParameter
              - …
            - BitwardenCreditCardDataParameter
              - …
            - OnePasswordCredentialParameter
              - …
            - AzureVaultCredentialParameter
              - …
            - OutputParameter
              - …
            - CredentialParameter
              - …
          - `value` union
            - string
            - integer
            - number
            - boolean
            - object
            - unknown[]
              - …
        - AWSSecretParameter
          - `parameter_type` 'aws_secret'
          - `key` string, required
          - `description` string, nullable
          - `aws_secret_parameter_id` string, required
          - `workflow_id` string, required
          - `aws_key` string, required
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - AzureSecretParameter
          - `parameter_type` 'azure_secret'
          - `key` string, required
          - `description` string, nullable
          - `azure_secret_parameter_id` string, required
          - `workflow_id` string, required
          - `azure_key` string, required
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - BitwardenLoginCredentialParameter
          - `parameter_type` 'bitwarden_login_credential'
          - `key` string, required
          - `description` string, nullable
          - `bitwarden_login_credential_parameter_id` string, required
          - `workflow_id` string, required
          - `bitwarden_client_id_aws_secret_key` string, required
          - `bitwarden_client_secret_aws_secret_key` string, required
          - `bitwarden_master_password_aws_secret_key` string, required
          - `url_parameter_key` string, nullable
          - `bitwarden_collection_id` string, nullable
          - `bitwarden_item_id` string, nullable
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - BitwardenSensitiveInformationParameter
          - `parameter_type` 'bitwarden_sensitive_information'
          - `key` string, required
          - `description` string, nullable
          - `bitwarden_sensitive_information_parameter_id` string, required
          - `workflow_id` string, required
          - `bitwarden_client_id_aws_secret_key` string, required
          - `bitwarden_client_secret_aws_secret_key` string, required
          - `bitwarden_master_password_aws_secret_key` string, required
          - `bitwarden_collection_id` string, required
          - `bitwarden_identity_key` string, required
          - `bitwarden_identity_fields` string[], required
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - BitwardenCreditCardDataParameter
          - `parameter_type` 'bitwarden_credit_card_data'
          - `key` string, required
          - `description` string, nullable
          - `bitwarden_credit_card_data_parameter_id` string, required
          - `workflow_id` string, required
          - `bitwarden_client_id_aws_secret_key` string, required
          - `bitwarden_client_secret_aws_secret_key` string, required
          - `bitwarden_master_password_aws_secret_key` string, required
          - `bitwarden_collection_id` string, required
          - `bitwarden_item_id` string, required
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - OnePasswordCredentialParameter
          - `parameter_type` 'onepassword'
          - `key` string, required
          - `description` string, nullable
          - `onepassword_credential_parameter_id` string, required
          - `workflow_id` string, required
          - `vault_id` string, required
          - `item_id` string, required
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - AzureVaultCredentialParameter
          - `parameter_type` 'azure_vault_credential'
          - `key` string, required
          - `description` string, nullable
          - `azure_vault_credential_parameter_id` string, required
          - `workflow_id` string, required
          - `vault_name` string, required
          - `username_key` string, required
          - `password_key` string, required
          - `totp_secret_key` string, nullable
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - OutputParameter
          - `parameter_type` 'output'
          - `key` string, required
          - `description` string, nullable
          - `output_parameter_id` string, required
          - `workflow_id` string, required
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
        - CredentialParameter
          - `parameter_type` 'credential'
          - `key` string, required
          - `description` string, nullable
          - `credential_parameter_id` string, required
          - `workflow_id` string, required
          - `credential_id` string, required
          - `credential_ids` string[], nullable
          - `selection_strategy` string, nullable
          - `fallback_credential_ids` string[], nullable
          - `fallback_trigger` string, nullable
          - `created_at` string, date-time, required
          - `modified_at` string, date-time, required
          - `deleted_at` string, date-time, nullable
    - `blocks` union[], required
      - union
        - ConditionalBlock — Branching block that selects the next block label based on list-ordered conditions.
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'conditional'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `branch_conditions` BranchCondition[]
            - `id` string
            - `criteria` union
              - …
            - `next_block_label` string, nullable
            - `description` string, nullable
            - `is_default` boolean
        - ForLoopBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'for_loop'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `loop_blocks` union[], required
            - union
              - …
          - `loop_over` union
            - WorkflowParameter
              - …
            - ContextParameter
              - …
            - AWSSecretParameter
              - …
            - AzureSecretParameter
              - …
            - BitwardenLoginCredentialParameter
              - …
            - BitwardenSensitiveInformationParameter
              - …
            - BitwardenCreditCardDataParameter
              - …
            - OnePasswordCredentialParameter
              - …
            - AzureVaultCredentialParameter
              - …
            - OutputParameter
              - …
            - CredentialParameter
              - …
          - `loop_variable_reference` string, nullable
          - `complete_if_empty` boolean
          - `data_schema` union
            - object
            - string
        - WhileLoopBlock — Loop block driven by a runtime condition. Iterates while ``condition`` evaluates truthy. Top-of-loop semantics: the condition is evaluated *before* each iteration (including the first). If the condition is false on the first check, the body never runs and the block returns success with an empty output list. Safety: the loop is capped at ``DEFAULT_MAX_LOOP_ITERATIONS`` (1000). Reaching the cap is treated as a failure so that a misbehaving condition can never spin forever.
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'while_loop'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `loop_blocks` union[], required
            - union
              - …
          - `condition` union, required
            - JinjaBranchCriteria — Jinja2-templated branch criteria (only supported criteria type for now).
              - …
            - PromptBranchCriteria — Natural language branch criteria.
              - …
        - TaskBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'task'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
        - CodeBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'code'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `code` string, required
          - `parameters` union[]
            - union
              - …
          - `prompt` string, nullable
          - `steps` CodeBlockStep[], nullable
            - `title` string, nullable
            - `description` string, nullable
            - `action_type` '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'
            - `line_start` integer, nullable
            - `line_end` integer, nullable
        - TextPromptBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'text_prompt'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `llm_key` string, nullable
          - `prompt` string, required
          - `parameters` union[]
            - union
              - …
          - `json_schema` object, nullable
        - DownloadToS3Block
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'download_to_s3'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `url` string, required
        - UploadToS3Block
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'upload_to_s3'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `path` string, nullable
        - SendEmailBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'send_email'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `smtp_host` AWSSecretParameter, required
            - `parameter_type` 'aws_secret'
            - `key` string, required
            - `description` string, nullable
            - `aws_secret_parameter_id` string, required
            - `workflow_id` string, required
            - `aws_key` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `smtp_port` AWSSecretParameter, required
            - `parameter_type` 'aws_secret'
            - `key` string, required
            - `description` string, nullable
            - `aws_secret_parameter_id` string, required
            - `workflow_id` string, required
            - `aws_key` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `smtp_username` AWSSecretParameter, required
            - `parameter_type` 'aws_secret'
            - `key` string, required
            - `description` string, nullable
            - `aws_secret_parameter_id` string, required
            - `workflow_id` string, required
            - `aws_key` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `smtp_password` AWSSecretParameter, required
            - `parameter_type` 'aws_secret'
            - `key` string, required
            - `description` string, nullable
            - `aws_secret_parameter_id` string, required
            - `workflow_id` string, required
            - `aws_key` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `sender` string, required
          - `recipients` string[], required
          - `subject` string, required
          - `body` string, required
          - `file_attachments` string[]
        - FileParserBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'file_url_parser'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `file_url` string, required
          - `file_type` 'auto_detect' | 'csv' | 'excel' | 'pdf' | 'image' | 'docx' | 'zip'
          - `json_schema` object, nullable
        - PDFParserBlock — DEPRECATED: Use FileParserBlock with file_type=FileType.PDF instead. This block will be removed in a future version.
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'pdf_parser'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `file_url` string, required
          - `json_schema` object, nullable
        - ValidationBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'validation'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
          - `without_page_information` boolean
        - ActionBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'action'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
          - `selector` string, nullable
          - `ai_fallback` 'fallback' | 'proactive' — Controls how an action block uses a CSS/XPath selector relative to AI. - `fallback`: attempt the selector first; fall back to AI on failure. - `proactive`: always use AI; the selector (if any) is a hint only. When `selector` is None, both modes degrade to AI-only — the difference is purely semantic (whether the author expected to have a selector here).
        - NavigationBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'navigation'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, required
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
        - ExtractionBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'extraction'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, required
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
        - LoginBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'login'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
          - `skip_saved_profile` boolean
        - WaitBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'wait'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `wait_sec` integer, required
          - `parameters` union[]
            - union
              - …
        - HumanInteractionBlock — A block for human/agent interaction. For the first pass at this, the implicit behaviour is that the user is given a single binary choice (a go//no-go). If the human: - chooses positively, the workflow continues - chooses negatively, the workflow is terminated - does not respond within the timeout period, the workflow terminates
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'human_interaction'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
          - `instructions` string
          - `positive_descriptor` string
          - `negative_descriptor` string
          - `timeout_seconds` integer
          - `sender` string
          - `recipients` string[]
          - `subject` string
          - `body` string
        - FileDownloadBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'file_download'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `s3_bucket` string, nullable
          - `aws_access_key_id` string, nullable
          - `aws_secret_access_key` string, nullable
          - `region_name` string, nullable
          - `azure_storage_account_name` string, nullable
          - `azure_storage_account_key` string, nullable
          - `azure_blob_container_name` string, nullable
          - `google_credential_id` string, nullable
          - `google_drive_folder_id` string, nullable
          - `sftp_host` string, nullable
          - `sftp_port` integer, nullable
          - `sftp_username` string, nullable
          - `sftp_password` string, nullable
          - `sftp_private_key` string, nullable
          - `sftp_private_key_passphrase` string, nullable
          - `sftp_remote_path` string, nullable
          - `sftp_host_key` string, nullable
          - `prompt` string, nullable — Optional natural-language control over which downloaded files are uploaded; empty means upload all.
          - `path` string, nullable
          - `continue_on_empty` boolean — When the run download directory has no files, allow the empty upload only after confirming no registered, browser-session, or alternate candidate downloads exist (False, default). Set True to always allow an empty upload.
          - `task_type` string
          - `url` string, nullable
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
          - `download_target` 'website' | 's3' | 'azure' | 'google_drive' | 'sftp'
        - UrlBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'goto_url'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `task_type` string
          - `url` string, required
          - `title` string
          - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
          - `complete_criterion` string, nullable
          - `complete_criterion_is_untrusted` boolean
          - `terminate_criterion` string, nullable
          - `navigation_goal` string, nullable
          - `data_extraction_goal` string, nullable
          - `data_schema` union
            - object
            - unknown[]
              - …
            - string
          - `error_code_mapping` object, nullable
          - `max_retries` integer
          - `max_steps_per_run` integer, nullable
          - `parameters` union[]
            - union
              - …
          - `complete_on_download` boolean
          - `download_suffix` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `complete_verification` boolean
          - `include_action_history_in_verification` boolean
          - `download_timeout` number, nullable
          - `include_extracted_text` boolean
        - TaskV2Block
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'task_v2'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `prompt` string, required
          - `url` string, nullable
          - `totp_verification_url` string, nullable
          - `totp_identifier` string, nullable
          - `max_iterations` integer
          - `max_steps` integer
        - FileUploadBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'file_upload'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `s3_bucket` string, nullable
          - `aws_access_key_id` string, nullable
          - `aws_secret_access_key` string, nullable
          - `region_name` string, nullable
          - `azure_storage_account_name` string, nullable
          - `azure_storage_account_key` string, nullable
          - `azure_blob_container_name` string, nullable
          - `google_credential_id` string, nullable
          - `google_drive_folder_id` string, nullable
          - `sftp_host` string, nullable
          - `sftp_port` integer, nullable
          - `sftp_username` string, nullable
          - `sftp_password` string, nullable
          - `sftp_private_key` string, nullable
          - `sftp_private_key_passphrase` string, nullable
          - `sftp_remote_path` string, nullable
          - `sftp_host_key` string, nullable
          - `prompt` string, nullable — Optional natural-language control over which downloaded files are uploaded; empty means upload all.
          - `path` string, nullable
          - `continue_on_empty` boolean — When the run download directory has no files, allow the empty upload only after confirming no registered, browser-session, or alternate candidate downloads exist (False, default). Set True to always allow an empty upload.
          - `storage_type` 's3' | 'azure' | 'google_drive' | 'sftp'
        - HttpRequestBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'http_request'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `method` string
          - `url` string, nullable
          - `headers` object, nullable
          - `body` object, nullable
          - `files` object, nullable
          - `timeout` integer
          - `follow_redirects` boolean
          - `download_filename` string, nullable
          - `save_response_as_file` boolean
          - `secret_response_paths` string[], nullable
          - `parameters` union[]
            - union
              - …
        - PrintPageBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'print_page'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `include_timestamp` boolean
          - `custom_filename` string, nullable
          - `format` string
          - `landscape` boolean
          - `print_background` boolean
          - `parameters` union[]
            - union
              - …
        - WorkflowTriggerBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'workflow_trigger'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `workflow_permanent_id` string, required
          - `payload` object, nullable
          - `wait_for_completion` boolean
          - `browser_session_id` string, nullable
          - `use_parent_browser_session` boolean
          - `parameters` union[]
            - union
              - …
        - GoogleSheetsReadBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'google_sheets_read'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `spreadsheet_url` string, required
          - `sheet_name` string, nullable
          - `range` string, nullable
          - `credential_id` string, nullable
          - `has_header_row` boolean
          - `parameters` union[]
            - union
              - …
        - EmailInboxBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'email_inbox'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `email_client` 'gmail' | 'outlook', required
          - `credential_id` string, nullable
          - `folder` string, nullable
          - `prompt` string, nullable
          - `sender` string, nullable
          - `subject` string, nullable
          - `newer_than_days` integer, nullable
          - `max_results` integer
          - `include_body` boolean
          - `parameters` union[]
            - union
              - …
        - GoogleSheetsWriteBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'google_sheets_write'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `spreadsheet_url` string, required
          - `sheet_name` string, nullable
          - `range` string, nullable
          - `credential_id` string, nullable
          - `write_mode` 'append' | 'update'
          - `values` string
          - `column_mapping` object, nullable
          - `create_sheet_if_missing` boolean
          - `parameters` union[]
            - union
              - …
        - PdfFillBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'pdf_fill'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `file_url` string, required
          - `prompt` string, required
          - `payload` union
            - object
            - unknown[]
              - …
            - string
          - `llm_key` string, nullable
          - `parameters` union[]
            - union
              - …
        - SplitPdfBlock
          - `label` string, required — Author-facing identifier for a block; unique within a workflow.
          - `next_block_label` string, nullable — Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted.
          - `block_type` 'split_pdf'
          - `output_parameter` OutputParameter, required
            - `parameter_type` 'output'
            - `key` string, required
            - `description` string, nullable
            - `output_parameter_id` string, required
            - `workflow_id` string, required
            - `created_at` string, date-time, required
            - `modified_at` string, date-time, required
            - `deleted_at` string, date-time, nullable
          - `continue_on_failure` boolean
          - `model` object, nullable
          - `disable_cache` boolean
          - `ignore_workflow_system_prompt` boolean
          - `next_loop_on_failure` boolean
          - `file_url` string, required
          - `prompt` string, required
          - `llm_key` string, nullable
          - `parameters` union[]
            - union
              - …
    - `finally_block_label` string, nullable
    - `error_code_mapping` object, nullable
    - `workflow_system_prompt` string, nullable
    - `completion_contract` object, nullable — Copilot-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.
  - `proxy_location` union
    - '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'
    - GeoTarget — Granular proxy geo-targeting request with country, optional subdivision, and optional city.
      - `country` string, required — ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE')
      - `subdivision` string, nullable — ISO 3166-2 subdivision code without country prefix (e.g., 'CA' for California, 'NY' for New York)
      - `city` string, nullable — City name in English from GeoNames (e.g., 'New York', 'Los Angeles', 'London')
    - object
  - `webhook_callback_url` string, nullable
  - `totp_verification_url` string, nullable
  - `totp_identifier` string, nullable
  - `persist_browser_session` boolean
  - `mask_secrets` boolean
  - `pin_saved_session_ip` boolean
  - `browser_profile_id` string, nullable
  - `browser_profile_key` string, nullable
  - `model` object, nullable
  - `status` 'published' | 'draft' | 'auto_generated' | 'importing' | 'import_failed'
  - `max_screenshot_scrolls` integer, nullable
  - `max_elapsed_time_minutes` integer, nullable
  - `extra_http_headers` object, nullable
  - `cdp_connect_headers` object, nullable
  - `run_with` string
  - `ai_fallback` boolean
  - `cache_key` string, nullable
  - `adaptive_caching` boolean
  - `enable_self_healing` boolean
  - `code_version` integer, nullable
  - `generate_script_on_terminal` boolean
  - `run_sequentially` boolean, nullable
  - `sequential_key` string, nullable
  - `folder_id` string, nullable
  - `import_error` string, nullable
  - `created_by` string, nullable
  - `edited_by` string, nullable
  - `copilot_authored` boolean
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `deleted_at` string, date-time, nullable
  - `agent_id` string, required — Alias of `workflow_permanent_id` — the stable agent identifier (starts with `wpid_`).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/5116249dfff3/schema)
