Skip to content

Skyvern: Scripts schemas

6 Skyvern schemas with complete fields and constraints.

← Scripts operations · All schemas

Create script — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
filesJSONOptionalArray of files to include in the script
files (anyOf 1)arrayAlternative
files (anyOf 1)[]ModelEach itemExpand Deploy script — request body — body files item
files (anyOf 2)nullAlternative
run_idJSONOptionalAssociated run ID
run_id (anyOf 1)stringAlternative
run_id (anyOf 2)nullAlternative
workflow_idJSONOptionalAssociated workflow ID
workflow_id (anyOf 1)stringAlternative
workflow_id (anyOf 2)nullAlternative

Referenced models: Deploy script — request body — body files item

Create script — response body

FieldTypePresenceDescription and constraints
$objectRoot
created_atstringRequired within parentTimestamp when the script was created
Format: date-time
file_countJSONRequired within parent
file_count (anyOf 1)integerAlternativeTotal number of files in the script
file_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
file_treeobjectRequired within parentHierarchical file tree structure
Additional keys: see wildcard field
file_tree.*ModelAdditional keysExpand Create script — response body — file tree value
run_idJSONOptionalID of the workflow run or task run that generated this script
run_id (anyOf 1)stringAlternative
run_id (anyOf 2)nullAlternative
script_idstringRequired within parentUnique script identifier
versionJSONRequired within parent
version (anyOf 1)integerAlternativeScript version number
version (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Create script — response body — file tree value

Create script — response body — file tree value

FieldTypePresenceDescription and constraints
$objectRootModel representing a file or directory in the file tree.
childrenJSONOptionalChild nodes for directories
children (anyOf 1)objectAlternativeAdditional keys: see wildcard field
children (anyOf 1).*ModelAdditional keysExpand Create script — response body — file tree value
children (anyOf 2)nullAlternative
content_hashJSONOptionalSHA256 hash of file content
content_hash (anyOf 1)stringAlternative
content_hash (anyOf 2)nullAlternative
created_atstringRequired within parentTimestamp when the file was created
Format: date-time
mime_typeJSONOptionalMIME type of the file
mime_type (anyOf 1)stringAlternative
mime_type (anyOf 2)nullAlternative
sizeJSONOptionalFile size in bytes
size (anyOf 1)JSONAlternative
size (anyOf 1) (anyOf 1)integerAlternative
size (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
size (anyOf 2)nullAlternative
typestringRequired within parentType of node: 'file' or 'directory'

Referenced models: Create script — response body — file tree value

Deploy script — request body — body

FieldTypePresenceDescription and constraints
$objectRootRequest model for deploying a script with updated files.
filesarrayRequired within parentArray of files to include in the script
files[]ModelEach itemExpand Deploy script — request body — body files item

Referenced models: Deploy script — request body — body files item

Deploy script — request body — body files item

FieldTypePresenceDescription and constraints
$objectRootModel representing a file in a script.
contentstringRequired within parentBase64 encoded file content
encodingstringOptionalSupported file content encodings.
Content encoding
One of: base64, utf-8
Default: base64
mime_typeJSONOptionalMIME type (auto-detected if not provided)
mime_type (anyOf 1)stringAlternative
mime_type (anyOf 2)nullAlternative
pathstringRequired within parentFile path relative to script root

Get script by ID — response body

FieldTypePresenceDescription and constraints
$objectRoot
created_atstringRequired within parentTimestamp when the script was created
Format: date-time
deleted_atJSONOptionalTimestamp when the script was soft deleted
deleted_at (anyOf 1)stringAlternativeFormat: date-time
deleted_at (anyOf 2)nullAlternative
modified_atstringRequired within parentTimestamp when the script was last modified
Format: date-time
organization_idstringRequired within parentID of the organization that owns this script
run_idJSONOptionalID of the workflow run or task run that generated this script
run_id (anyOf 1)stringAlternative
run_id (anyOf 2)nullAlternative
script_idstringRequired within parentUser-facing script identifier, consistent across versions
script_revision_idstringRequired within parentUnique identifier for this specific script revision
versionJSONRequired within parent
version (anyOf 1)integerAlternativeVersion number of the script
version (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

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.