SKskyvern-ai
Agents

Get an agent by id

Changed on

Fetch a single agent definition by its permanent id, optionally pinned to a specific version. Returns the agent's blocks, parameters, and metadata.

get/v1/agents/{workflow_permanent_id}

Request

  • Base URL
    https://api.skyvern.com
  • URL
    https://api.skyvern.com/v1/agents/{workflow_permanent_id}
  • Auth
    none declared

Path parameters

workflow_permanent_idstring required

Query parameters

versioninteger nullable
templateboolean

Headers

x-api-keystring nullable

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

Response

Successful Response

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
reuse_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
browser_typestring nullable
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
effective_default_engine'skyvern-1.0' | 'skyvern-2.0' | 'skyvern-3.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator'
original_created_bystring nullable

Who created the agent's first version. Populated by the list endpoint only.

original_created_atstring date-time nullable

When the agent's first version was created. Populated by the list endpoint only.

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_).

Changes

  • 89fc67079375Revision changes
    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property ////////// from the response with the status

    • warning

      removed the optional property ////////// from the response with the status

    • warning

      removed the optional property ////////// from the response with the status

    • warning

      removed the optional property ////////// from the response with the status

    • warning

      removed the optional property ////////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

  • 7b0a0c6ac6c7Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property ////////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status