v65

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0386234904.1 KB

Folders

Update agent folder

Update a workflow's folder assignment for the latest version

put/v1/agents/{workflow_permanent_id}/folder

Path parameters

workflow_permanent_idstring required

Workflow permanent ID

Example:wpid_123

Workflow permanent ID

Headers

x-api-keystring nullable

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Request body

folder_idstring nullable

Folder ID to assign workflow to. Set to null to remove from folder.

Response

Successfully updated workflow folder

workflow_idstring required

organization_idstring required

titlestring required

workflow_permanent_idstring required

versioninteger required

is_saved_taskboolean required

is_templateboolean

descriptionstring nullable

webhook_callback_urlstring nullable

totp_verification_urlstring nullable

totp_identifierstring nullable

persist_browser_sessionboolean

mask_secretsboolean

pin_saved_session_ipboolean

browser_profile_idstring nullable

browser_profile_keystring nullable

modelobject nullable

status'published' | 'draft' | 'auto_generated' | 'importing' | 'import_failed'

max_screenshot_scrollsinteger nullable

max_elapsed_time_minutesinteger nullable

extra_http_headersobject nullable

cdp_connect_headersobject nullable

run_withstring

ai_fallbackboolean

cache_keystring nullable

adaptive_cachingboolean

enable_self_healingboolean

code_versioninteger nullable

generate_script_on_terminalboolean

run_sequentiallyboolean nullable

sequential_keystring nullable

folder_idstring nullable

import_errorstring nullable

created_bystring nullable

edited_bystring nullable

copilot_authoredboolean

created_atstring date-time required

modified_atstring date-time required

deleted_atstring date-time nullable

agent_idstring required

Alias of workflow_permanent_id — the stable agent identifier (starts with wpid_).