Get all agents
Get all workflows with the latest version for the organization.
Search semantics:
- If
search_keyis provided, its value is used as a unified search term forworkflows.title,folders.title, and workflow parameter metadata (key, description, and default_value forWorkflowParameterModel). - Falls back to deprecated
title(title-only search) ifsearch_keyis not provided. - Parameter metadata search excludes soft-deleted parameter rows across all parameter tables.
Headers
Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.
Query Parameters
x >= 1x >= 1Case-insensitive substring search across: workflow title, folder name, and parameter metadata (key, description, default_value). A workflow is returned if any of these fields match. Soft-deleted parameter definitions are excluded. Takes precedence over the deprecated title parameter.
"my_workflow"
Deprecated: use search_key instead. Falls back to title-only search if search_key is not provided.
Filter workflows by folder ID
published, draft, auto_generated, importing, import_failed Filter by tags. Each term is a label (production), a group (env:*), or a group:label (env:prod). Repeat the param or comma-separate (?tags=env:prod,env:staging). AND across distinct terms, OR within a group's labels (?tags=customer:acme,env:prod,env:staging -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only. Not supported with template=true.
20"env:prod"
Response
Successful Response
Alias of workflow_permanent_id — the stable agent identifier (starts with wpid_).
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 published, draft, auto_generated, importing, import_failed The 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.
skyvern-1.0, skyvern-2.0, skyvern-3.0, openai-cua, anthropic-cua, ui-tars, yutori-navigator Who created the agent's first version. Populated by the list endpoint only.
When the agent's first version was created. Populated by the list endpoint only.

