Skip to content

Automate browser based workflows with AI

fix(runs-history): guard sub-3-char search + render load-error state (#7401)

Shuchang Zheng52fbfeb68627
diff --git a/fern/openapi/skyvern_openapi.json b/fern/openapi/skyvern_openapi.json
index d8d540495..de8880c90 100644
--- a/fern/openapi/skyvern_openapi.json
+++ b/fern/openapi/skyvern_openapi.json
@@ -135,8 +135,10 @@
"type": "null"
}
],
+ "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
"title": "X-Api-Key"
- }
+ },
+ "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
},
{
"name": "x-max-steps-override",
@@ -1370,29 +1372,15 @@
"x-fern-sdk-method-name": "delete_folder"
}
},
- "/v1/runs/{workflow_run_id}/tags": {
- "post": {
+ "/v1/tag-keys": {
+ "get": {
"tags": [
"Tags"
],
- "summary": "Apply run tags",
- "description": "Atomically apply tag changes to a workflow run. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.",
- "operationId": "apply_run_tags_v1_runs__workflow_run_id__tags_post",
+ "summary": "List tag keys",
+ "description": "List all tag keys registered for the organization with their descriptions.",
+ "operationId": "list_tag_keys_v1_tag_keys_get",
"parameters": [
- {
- "name": "workflow_run_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "Workflow run ID",
- "examples": [
- "wr_123"
- ],
- "title": "Workflow Run Id"
- },
- "description": "Workflow run ID"
- },
{
"name": "x-api-key",
"in": "header",
@@ -1412,57 +1400,54 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagApplyRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully applied tag changes",
+ "description": "Successfully retrieved tag keys",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagsResponse"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/TagKey"
+ },
+ "title": "Response List Tag Keys V1 Tag Keys Get"
}
}
}
},
- "404": {
- "description": "Workflow run not found"
- },
"422": {
- "description": "Invalid tag key or value"
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ }
}
},
- "x-fern-sdk-method-name": "apply_run_tags"
- },
- "get": {
+ "x-fern-sdk-method-name": "list_tag_keys"
+ }
+ },
+ "/v1/tag-keys/{key}": {
+ "patch": {
"tags": [
"Tags"
],
- "summary": "Get run tags",
- "description": "Get the current tag state for a workflow run.",
- "operationId": "get_run_tags_v1_runs__workflow_run_id__tags_get",
+ "summary": "Update tag key",
+ "description": "Update the description for a tag key.",
+ "operationId": "update_tag_key_v1_tag_keys__key__patch",
"parameters": [
{
- "name": "workflow_run_id",
+ "name": "key",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "Workflow run ID",
- "examples": [
- "wr_123"
- ],
- "title": "Workflow Run Id"
+ "description": "Tag key to update",
+ "title": "Key"
},
- "description": "Workflow run ID"
+ "description": "Tag key to update"
},
{
"name": "x-api-key",
@@ -1483,57 +1468,44 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TagKeyUpdate"
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully retrieved tags",
+ "description": "Successfully updated tag key",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagsResponse"
+ "$ref": "#/components/schemas/TagKey"
}
}
}
},
"404": {
- "description": "Workflow run not found"
+ "description": "Tag key not found"
},
"422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
+ "description": "Description too long"
}
},
- "x-fern-sdk-method-name": "get_run_tags"
- }
- },
- "/v1/runs/{workflow_run_id}/tags/{key}": {
+ "x-fern-sdk-method-name": "update_tag_key"
+ },
"delete": {
"tags": [
"Tags"
],
- "summary": "Delete run tag",
- "description": "Soft-delete a single grouped tag from a workflow run. Writes a DELETE event row.",
- "operationId": "delete_run_tag_v1_runs__workflow_run_id__tags__key__delete",
+ "summary": "Delete tag key",
+ "description": "Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.",
+ "operationId": "delete_tag_key_v1_tag_keys__key__delete",
"parameters": [
- {
- "name": "workflow_run_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "Workflow run ID",
- "examples": [
- "wr_123"
- ],
- "title": "Workflow Run Id"
- },
- "description": "Workflow run ID"
- },
{
"name": "key",
"in": "path",
@@ -1547,39 +1519,21 @@
"title": "Key"
},
"description": "Tag key to delete"
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
"responses": {
"200": {
- "description": "Successfully deleted tag (or no-op if absent)",
+ "description": "Successfully deleted tag key",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagsResponse"
+ "$ref": "#/components/schemas/TagKeyDeleteResponse"
}
}
}
},
"404": {
- "description": "Workflow run not found"
+ "description": "Tag key not found"
},
"422": {
"description": "Validation Error",
@@ -1592,67 +1546,20 @@
}
}
},
- "x-fern-sdk-method-name": "delete_run_tag"
+ "x-fern-sdk-method-name": "delete_tag_key"
}
},
- "/v1/runs/{workflow_run_id}/tags/history": {
+ "/v1/workflow-tags": {
"get": {
"tags": [
"Tags"
],
- "summary": "Get run tag history",
- "description": "Chronological tag-event log for a workflow run (newest first). Includes SET and DELETE events.",
- "operationId": "get_run_tag_history_v1_runs__workflow_run_id__tags_history_get",
+ "summary": "Batch get agent tags",
+ "description": "Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.",
+ "operationId": "batch_get_workflow_tags_v1_workflow_tags_get",
"parameters": [
{
- "name": "workflow_run_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "Workflow run ID",
- "examples": [
- "wr_123"
- ],
- "title": "Workflow Run Id"
- },
- "description": "Workflow run ID"
- },
- {
- "name": "limit",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "maximum": 500,
- "minimum": 1,
- "description": "Max events to return",
- "default": 100,
- "title": "Limit"
- },
- "description": "Max events to return"
- },
- {
- "name": "since",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "description": "Only return events at or after this timestamp",
- "title": "Since"
- },
- "description": "Only return events at or after this timestamp"
- },
- {
- "name": "key",
+ "name": "workflow_permanent_ids",
"in": "query",
"required": false,
"schema": {
@@ -1664,10 +1571,13 @@
"type": "null"
}
],
- "description": "Filter to events for a single tag key",
- "title": "Key"
+ "description": "Comma-separated workflow permanent IDs",
+ "examples": [
+ "wpid_123,wpid_456"
+ ],
+ "title": "Workflow Permanent Ids"
},
- "description": "Filter to events for a single tag key"
+ "description": "Comma-separated workflow permanent IDs"
},
{
"name": "x-api-key",
@@ -1690,17 +1600,17 @@
],
"responses": {
"200": {
- "description": "Successfully retrieved tag history",
+ "description": "Successfully retrieved tags",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagHistoryResponse"
+ "$ref": "#/components/schemas/WorkflowTagsBatchResponse"
}
}
}
},
- "404": {
- "description": "Workflow run not found"
+ "400": {
+ "description": "Too many workflow IDs requested"
},
"422": {
"description": "Validation Error",
@@ -1713,17 +1623,16 @@
}
}
},
- "x-fern-sdk-method-name": "get_run_tag_history"
- }
- },
- "/v1/tag-keys": {
- "get": {
+ "x-hidden": true,
+ "x-fern-sdk-method-name": "batch_get_workflow_tags"
+ },
+ "post": {
"tags": [
"Tags"
],
- "summary": "List tag keys",
- "description": "List all tag keys registered for the organization with their descriptions.",
- "operationId": "list_tag_keys_v1_tag_keys_get",
+ "summary": "Batch get agent tags (POST)",
+ "description": "Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).",
+ "operationId": "batch_get_workflow_tags_post_v1_workflow_tags_post",
"parameters": [
{
"name": "x-api-key",
@@ -1744,21 +1653,30 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/WorkflowTagsBatchRequest"
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully retrieved tag keys",
+ "description": "Successfully retrieved tags",
"content": {
"application/json": {
"schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/TagKey"
- },
- "title": "Response List Tag Keys V1 Tag Keys Get"
+ "$ref": "#/components/schemas/WorkflowTagsBatchResponse"
}
}
}
},
+ "400": {
+ "description": "Too many workflow IDs requested"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -1770,132 +1688,49 @@
}
}
},
- "x-fern-sdk-method-name": "list_tag_keys"
+ "x-hidden": true,
+ "x-fern-sdk-method-name": "batch_get_workflow_tags_post"
}
},
- "/v1/tag-keys/{key}": {
- "patch": {
+ "/v1/artifacts/{artifact_id}/content": {
+ "get": {
"tags": [
- "Tags"
+ "Artifacts"
],
- "summary": "Update tag key",
- "description": "Update the description for a tag key.",
- "operationId": "update_tag_key_v1_tag_keys__key__patch",
+ "summary": "Get artifact content",
+ "description": "Download the raw content of an artifact (supports bundled artifacts).",
+ "operationId": "get_artifact_content_v1_artifacts__artifact_id__content_get",
"parameters": [
{
- "name": "key",
+ "name": "artifact_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "Tag key to update",
- "title": "Key"
- },
- "description": "Tag key to update"
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagKeyUpdate"
- }
+ "title": "Artifact Id"
}
}
- },
+ ],
"responses": {
"200": {
- "description": "Successfully updated tag key",
+ "description": "Raw artifact content",
"content": {
"application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagKey"
- }
+ "schema": {}
}
}
},
- "404": {
- "description": "Tag key not found"
- },
- "422": {
- "description": "Description too long"
- }
- },
- "x-fern-sdk-method-name": "update_tag_key"
- },
- "delete": {
- "tags": [
- "Tags"
- ],
- "summary": "Delete tag key",
- "description": "Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.",
- "operationId": "delete_tag_key_v1_tag_keys__key__delete",
- "parameters": [
- {
- "name": "key",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "Tag key to delete",
- "examples": [
- "env"
- ],
- "title": "Key"
- },
- "description": "Tag key to delete"
+ "206": {
+ "description": "Partial artifact content (Range request)"
},
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successfully deleted tag key",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagKeyDeleteResponse"
- }
- }
- }
+ "403": {
+ "description": "Invalid or expired artifact URL"
},
"404": {
- "description": "Tag key not found"
+ "description": "Artifact not found or content unavailable"
+ },
+ "416": {
+ "description": "Range not satisfiable"
},
"422": {
"description": "Validation Error",
@@ -1907,36 +1742,47 @@
}
}
}
- },
- "x-fern-sdk-method-name": "delete_tag_key"
+ }
}
},
- "/v1/tag-values": {
+ "/v1/runs/{run_id}/artifacts": {
"get": {
"tags": [
- "Tags"
+ "Artifacts"
],
- "summary": "List tag values",
- "description": "List the palette color and current workflow usage count for each grouped tag (key, value) for the organization. The frontend joins these onto tags by (key, value); workflow_count is the number of non-deleted workflows carrying the label and powers the per-label usage and delete blast-radius warnings.",
- "operationId": "list_tag_values_v1_tag_values_get",
+ "summary": "Get artifacts for a run",
+ "description": "Get artifacts for a run",
+ "operationId": "get_run_artifacts_v1_runs__run_id__artifacts_get",
"parameters": [
{
- "name": "key",
+ "name": "run_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "description": "The id of the task run or the workflow run.",
+ "title": "Run Id"
+ },
+ "description": "The id of the task run or the workflow run."
+ },
+ {
+ "name": "artifact_type",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
- "type": "string"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ArtifactType"
+ }
},
{
"type": "null"
}
],
- "description": "Filter to values for a single tag key",
- "title": "Key"
- },
- "description": "Filter to values for a single tag key"
+ "title": "Artifact Type"
+ }
},
{
"name": "x-api-key",
@@ -1959,15 +1805,15 @@
],
"responses": {
"200": {
- "description": "Successfully retrieved tag values",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
- "$ref": "#/components/schemas/TagValue"
+ "$ref": "#/components/schemas/Artifact"
},
- "title": "Response List Tag Values V1 Tag Values Get"
+ "title": "Response Get Run Artifacts V1 Runs Run Id Artifacts Get"
}
}
}
@@ -1983,31 +1829,32 @@
}
}
},
- "x-fern-sdk-method-name": "list_tag_values"
+ "x-fern-sdk-method-name": "get_run_artifacts"
}
},
- "/v1/tag-values/{key}": {
- "patch": {
+ "/v1/runs/{run_id}/retry_webhook": {
+ "post": {
"tags": [
- "Tags"
+ "Runs"
],
- "summary": "Update tag value color",
- "description": "Recolor a grouped tag (key, value). The value is supplied in the body so values containing '/' stay addressable. The new color must be a palette name.",
- "operationId": "update_tag_value_v1_tag_values__key__patch",
+ "summary": "Replay a run webhook",
+ "description": "Retry sending the webhook for a run",
+ "operationId": "retry_run_webhook_v1_runs__run_id__retry_webhook_post",
"parameters": [
{
- "name": "key",
+ "name": "run_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "Tag key (group)",
+ "description": "The id of the task run or the workflow run.",
"examples": [
- "env"
+ "tsk_123",
+ "wr_123"
],
- "title": "Key"
+ "title": "Run Id"
},
- "description": "Tag key (group)"
+ "description": "The id of the task run or the workflow run."
},
{
"name": "x-api-key",
@@ -2029,56 +1876,84 @@
}
],
"requestBody": {
- "required": true,
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagValueUpdate"
+ "anyOf": [
+ {
+ "$ref": "#/components/schemas/RetryRunWebhookRequest"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Request"
}
}
}
},
"responses": {
"200": {
- "description": "Successfully recolored tag value",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagValue"
+ "$ref": "#/components/schemas/RunWebhookReplayResponse"
}
}
}
},
- "404": {
- "description": "Tag value not found"
- },
"422": {
- "description": "Invalid palette color"
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ }
}
},
- "x-fern-sdk-method-name": "update_tag_value"
- },
- "delete": {
+ "x-fern-sdk-method-name": "retry_run_webhook",
+ "x-fern-examples": [
+ {
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.retry_run_webhook(run_id=\"tsk_v2_123\")\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.retryRunWebhook(\"tsk_v2_123\");\n"
+ }
+ ]
+ }
+ ]
+ }
+ },
+ "/v1/runs/{run_id}/timeline": {
+ "get": {
"tags": [
- "Tags"
+ "Runs"
],
- "summary": "Delete tag value",
- "description": "Soft-delete a grouped tag (key, value) and remove that label from every workflow carrying it (cascade). The value rides in the body so values containing '/' stay addressable. Returns how many workflows the label was removed from.",
- "operationId": "delete_tag_value_v1_tag_values__key__delete",
+ "summary": "Get run timeline",
+ "description": "Get timeline for a run (workflow run or task_v2 run)",
+ "operationId": "get_run_timeline_v1_runs__run_id__timeline_get",
"parameters": [
{
- "name": "key",
+ "name": "run_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "Tag key (group)",
+ "description": "The id of the workflow run or task_v2 run.",
"examples": [
- "env"
+ "wr_123",
+ "tsk_v2_123"
],
- "title": "Key"
+ "title": "Run Id"
},
- "description": "Tag key (group)"
+ "description": "The id of the workflow run or task_v2 run."
},
{
"name": "x-api-key",
@@ -2099,29 +1974,26 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagValueDelete"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully deleted tag value",
+ "description": "Successfully retrieved run timeline",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagValueDeleteResponse"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/WorkflowRunTimeline"
+ },
+ "title": "Response Get Run Timeline V1 Runs Run Id Timeline Get"
}
}
}
},
"404": {
- "description": "Tag value not found"
+ "description": "Run not found"
+ },
+ "400": {
+ "description": "Timeline not available for this run type"
},
"422": {
"description": "Validation Error",
@@ -2134,170 +2006,124 @@
}
}
},
- "x-fern-sdk-method-name": "delete_tag_value"
+ "x-fern-sdk-method-name": "get_run_timeline",
+ "x-fern-examples": [
+ {
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\n# Get timeline for a workflow run\ntimeline = await skyvern.get_run_timeline(run_id=\"wr_123\")\nprint(timeline)\n\n# Get timeline for a task_v2 run\ntimeline = await skyvern.get_run_timeline(run_id=\"tsk_v2_123\")\nprint(timeline)\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\n// Get timeline for a workflow run\nconst timeline = await skyvern.getRunTimeline(\"wr_123\");\nconsole.log(timeline);\n\n// Get timeline for a task_v2 run\nconst timeline2 = await skyvern.getRunTimeline(\"tsk_v2_123\");\nconsole.log(timeline2);\n"
+ }
+ ]
+ }
+ ]
}
},
- "/v1/tag-values/{key}/rename": {
- "patch": {
+ "/v1/version": {
+ "get": {
"tags": [
- "Tags"
+ "Server"
],
- "summary": "Rename tag value",
- "description": "Rename a grouped tag (key, value) to (key, new_value). The cascade re-tags every workflow carrying the old label; the new label inherits the old color. Both values ride in the body so values containing '/' stay addressable. Rejects with 409 when the new value already exists for the key.",
- "operationId": "rename_tag_value_v1_tag_values__key__rename_patch",
- "parameters": [
- {
- "name": "key",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "Tag key (group)",
- "examples": [
- "env"
- ],
- "title": "Key"
- },
- "description": "Tag key (group)"
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagValueRename"
- }
- }
- }
- },
+ "summary": "Get server version",
+ "description": "Returns the current Skyvern server version (git SHA for official builds).",
+ "operationId": "get_version_v1_version_get",
"responses": {
"200": {
- "description": "Successfully renamed tag value",
+ "description": "Current server version",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagValueRenameResponse"
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": "object",
+ "title": "Response Get Version V1 Version Get"
}
}
}
- },
- "404": {
- "description": "Tag value not found"
- },
- "409": {
- "description": "Target value already exists for this key"
- },
- "422": {
- "description": "Invalid value"
}
},
- "x-fern-sdk-method-name": "rename_tag_value"
+ "x-fern-sdk-method-name": "get_version"
}
},
- "/v1/workflow-tags": {
+ "/v1/runs": {
"get": {
"tags": [
- "Tags"
+ "agent"
],
- "summary": "Batch get agent tags",
- "description": "Batch fetch current tags for many workflows. Avoids N+1 on the workflows-list page.",
- "operationId": "batch_get_workflow_tags_v1_workflow_tags_get",
+ "summary": "Get Runs V2",
+ "operationId": "get_runs_v2_v1_runs_get",
"parameters": [
{
- "name": "workflow_permanent_ids",
+ "name": "page",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "minimum": 1,
+ "default": 1,
+ "title": "Page"
+ }
+ },
+ {
+ "name": "page_size",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "minimum": 1,
+ "default": 10,
+ "title": "Page Size"
+ }
+ },
+ {
+ "name": "status",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
- "type": "string"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/RunStatus"
+ }
},
{
"type": "null"
}
],
- "description": "Comma-separated workflow permanent IDs",
- "examples": [
- "wpid_123,wpid_456"
- ],
- "title": "Workflow Permanent Ids"
- },
- "description": "Comma-separated workflow permanent IDs"
+ "title": "Status"
+ }
},
{
- "name": "x-api-key",
- "in": "header",
+ "name": "search_key",
+ "in": "query",
"required": false,
"schema": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "minLength": 3
},
{
"type": "null"
}
],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
+ "description": "Case-insensitive substring search (min 3 chars for trigram index).",
+ "examples": [
+ "login_url",
+ "wr_abc123"
+ ],
+ "title": "Search Key"
},
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successfully retrieved tags",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowTagsBatchResponse"
- }
- }
- }
- },
- "400": {
- "description": "Too many workflow IDs requested"
+ "description": "Case-insensitive substring search (min 3 chars for trigram index)."
},
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- },
- "x-hidden": true,
- "x-fern-sdk-method-name": "batch_get_workflow_tags"
- },
- "post": {
- "tags": [
- "Tags"
- ],
- "summary": "Batch get agent tags (POST)",
- "description": "Batch fetch current tags for many workflows (POST variant for id lists exceeding URL length).",
- "operationId": "batch_get_workflow_tags_post_v1_workflow_tags_post",
- "parameters": [
{
"name": "x-api-key",
"in": "header",
@@ -2317,30 +2143,21 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowTagsBatchRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully retrieved tags",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/WorkflowTagsBatchResponse"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/TaskRunListItem"
+ },
+ "title": "Response Get Runs V2 V1 Runs Get"
}
}
}
},
- "400": {
- "description": "Too many workflow IDs requested"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -2353,39 +2170,17 @@
}
},
"x-hidden": true,
- "x-fern-sdk-method-name": "batch_get_workflow_tags_post"
+ "x-fern-sdk-method-name": "get_runs_v2"
}
},
- "/v1/run-tags": {
- "get": {
+ "/v1/upload_file": {
+ "post": {
"tags": [
- "Tags"
+ "Files"
],
- "summary": "Batch get run tags",
- "description": "Batch fetch current tags for many workflow runs. Avoids N+1 on run-list pages.",
- "operationId": "batch_get_run_tags_v1_run_tags_get",
+ "summary": "Upload File",
+ "operationId": "upload_file_v1_upload_file_post",
"parameters": [
- {
- "name": "workflow_run_ids",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Comma-separated workflow run IDs",
- "examples": [
- "wr_123,wr_456"
- ],
- "title": "Workflow Run Ids"
- },
- "description": "Comma-separated workflow run IDs"
- },
{
"name": "x-api-key",
"in": "header",
@@ -2405,20 +2200,27 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "multipart/form-data": {
+ "schema": {
+ "$ref": "#/components/schemas/Body_upload_file_v1_upload_file_post"
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully retrieved tags",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagsBatchResponse"
+ "$ref": "#/components/schemas/UploadFileResponse"
}
}
}
},
- "400": {
- "description": "Too many workflow run IDs requested"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -2430,16 +2232,17 @@
}
}
},
- "x-hidden": true,
- "x-fern-sdk-method-name": "batch_get_run_tags"
- },
+ "x-fern-sdk-method-name": "upload_file"
+ }
+ },
+ "/v1/browser_profiles": {
"post": {
"tags": [
- "Tags"
+ "Browser Profiles"
],
- "summary": "Batch get run tags (POST)",
- "description": "Batch fetch current tags for many workflow runs (POST variant for id lists exceeding URL length).",
- "operationId": "batch_get_run_tags_post_v1_run_tags_post",
+ "summary": "Create a browser profile",
+ "description": "Create a blank browser profile, or create one from a persistent browser session or workflow run.",
+ "operationId": "create_browser_profile_v1_browser_profiles_post",
"parameters": [
{
"name": "x-api-key",
@@ -2465,24 +2268,27 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagsBatchRequest"
+ "$ref": "#/components/schemas/CreateBrowserProfileRequest"
}
}
}
},
"responses": {
"200": {
- "description": "Successfully retrieved tags",
+ "description": "Successfully created browser profile",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunTagsBatchResponse"
+ "$ref": "#/components/schemas/BrowserProfile"
}
}
}
},
"400": {
- "description": "Too many workflow run IDs requested"
+ "description": "Invalid request - source not found or source archive unavailable"
+ },
+ "409": {
+ "description": "Browser profile name already exists"
},
"422": {
"description": "Validation Error",
@@ -2495,101 +2301,85 @@
}
}
},
- "x-hidden": true,
- "x-fern-sdk-method-name": "batch_get_run_tags_post"
- }
- },
- "/v1/artifacts/{artifact_id}/content": {
- "get": {
- "tags": [
- "Artifacts"
- ],
- "summary": "Get artifact content",
- "description": "Download the raw content of an artifact (supports bundled artifacts).",
- "operationId": "get_artifact_content_v1_artifacts__artifact_id__content_get",
- "parameters": [
+ "x-fern-sdk-method-name": "create_browser_profile",
+ "x-fern-examples": [
{
- "name": "artifact_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Artifact Id"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "Raw artifact content",
- "content": {
- "application/json": {
- "schema": {}
- }
- }
- },
- "206": {
- "description": "Partial artifact content (Range request)"
- },
- "403": {
- "description": "Invalid or expired artifact URL"
- },
- "404": {
- "description": "Artifact not found or content unavailable"
- },
- "416": {
- "description": "Range not satisfiable"
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\n# Create a blank browser profile for future runs\nblank_profile = await skyvern.browser_profiles.create_browser_profile(\n name=\"Fresh Profile\",\n)\nprint(blank_profile)\n\n# Create a browser profile from a persistent browser session\nbrowser_profile = await skyvern.browser_profiles.create_browser_profile(\n name=\"My Profile\",\n browser_session_id=\"pbs_123\",\n)\nprint(browser_profile)\n\n# Or create from a workflow run with persist_browser_session=True\nbrowser_profile = await skyvern.browser_profiles.create_browser_profile(\n name=\"My Profile\",\n workflow_run_id=\"wr_123\",\n)\nprint(browser_profile)\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\n// Create a blank browser profile for future runs\nconst blankProfile = await skyvern.browserProfiles.createBrowserProfile({\n name: \"Fresh Profile\",\n});\nconsole.log(blankProfile);\n\n// Create a browser profile from a persistent browser session\nconst browserProfile = await skyvern.browserProfiles.createBrowserProfile({\n name: \"My Profile\",\n browser_session_id: \"pbs_123\",\n});\nconsole.log(browserProfile);\n\n// Or create from a workflow run with persist_browser_session=True\nconst browserProfile2 = await skyvern.browserProfiles.createBrowserProfile({\n name: \"My Profile\",\n workflow_run_id: \"wr_123\",\n});\nconsole.log(browserProfile2);\n"
}
- }
+ ]
}
- }
- }
- },
- "/v1/runs/{run_id}/artifacts": {
+ ]
+ },
"get": {
"tags": [
- "Artifacts"
+ "Browser Profiles"
],
- "summary": "Get artifacts for a run",
- "description": "Get artifacts for a run",
- "operationId": "get_run_artifacts_v1_runs__run_id__artifacts_get",
+ "summary": "List browser profiles",
+ "description": "Get all browser profiles for the organization",
+ "operationId": "list_browser_profiles_v1_browser_profiles_get",
"parameters": [
{
- "name": "run_id",
- "in": "path",
- "required": true,
+ "name": "page",
+ "in": "query",
+ "required": false,
"schema": {
- "type": "string",
- "description": "The id of the task run or the workflow run.",
- "title": "Run Id"
+ "type": "integer",
+ "minimum": 1,
+ "default": 1,
+ "title": "Page"
+ }
+ },
+ {
+ "name": "page_size",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "minimum": 1,
+ "default": 10,
+ "title": "Page Size"
+ }
+ },
+ {
+ "name": "include_deleted",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "boolean",
+ "description": "Include deleted browser profiles",
+ "default": false,
+ "title": "Include Deleted"
},
- "description": "The id of the task run or the workflow run."
+ "description": "Include deleted browser profiles"
},
{
- "name": "artifact_type",
+ "name": "search_key",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ArtifactType"
- }
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Artifact Type"
- }
+ "description": "Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.",
+ "examples": [
+ "my_profile",
+ "production"
+ ],
+ "title": "Search Key"
+ },
+ "description": "Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches."
},
{
"name": "x-api-key",
@@ -2612,15 +2402,15 @@
],
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully retrieved browser profiles",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
- "$ref": "#/components/schemas/Artifact"
+ "$ref": "#/components/schemas/BrowserProfile"
},
- "title": "Response Get Run Artifacts V1 Runs Run Id Artifacts Get"
+ "title": "Response List Browser Profiles V1 Browser Profiles Get"
}
}
}
@@ -2636,32 +2426,45 @@
}
}
},
- "x-fern-sdk-method-name": "get_run_artifacts"
+ "x-fern-sdk-method-name": "list_browser_profiles",
+ "x-fern-examples": [
+ {
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_profiles = await skyvern.browser_profiles.list_browser_profiles()\nprint(browser_profiles)\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserProfiles = await skyvern.browserProfiles.listBrowserProfiles();\nconsole.log(browserProfiles);\n"
+ }
+ ]
+ }
+ ]
}
},
- "/v1/runs/{run_id}/retry_webhook": {
- "post": {
+ "/v1/browser_profiles/{profile_id}": {
+ "get": {
"tags": [
- "Runs"
+ "Browser Profiles"
],
- "summary": "Replay a run webhook",
- "description": "Retry sending the webhook for a run",
- "operationId": "retry_run_webhook_v1_runs__run_id__retry_webhook_post",
+ "summary": "Get browser profile",
+ "description": "Get a specific browser profile by ID",
+ "operationId": "get_browser_profile_v1_browser_profiles__profile_id__get",
"parameters": [
{
- "name": "run_id",
+ "name": "profile_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The id of the task run or the workflow run.",
+ "description": "The ID of the browser profile. browser_profile_id starts with `bp_`",
"examples": [
- "tsk_123",
- "wr_123"
+ "bp_123456"
],
- "title": "Run Id"
+ "title": "Profile Id"
},
- "description": "The id of the task run or the workflow run."
+ "description": "The ID of the browser profile. browser_profile_id starts with `bp_`"
},
{
"name": "x-api-key",
@@ -2682,34 +2485,20 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/RetryRunWebhookRequest"
- },
- {
- "type": "null"
- }
- ],
- "title": "Request"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully retrieved browser profile",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/RunWebhookReplayResponse"
+ "$ref": "#/components/schemas/BrowserProfile"
}
}
}
},
+ "404": {
+ "description": "Browser profile not found"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -2721,46 +2510,43 @@
}
}
},
- "x-fern-sdk-method-name": "retry_run_webhook",
+ "x-fern-sdk-method-name": "get_browser_profile",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.retry_run_webhook(run_id=\"tsk_v2_123\")\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_profile = await skyvern.browser_profiles.get_browser_profile(\"bp_123\")\nprint(browser_profile)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.retryRunWebhook(\"tsk_v2_123\");\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserProfile = await skyvern.browserProfiles.getBrowserProfile(\"bp_123\");\nconsole.log(browserProfile);\n"
}
]
}
]
- }
- },
- "/v1/runs/{run_id}/timeline": {
- "get": {
+ },
+ "patch": {
"tags": [
- "Runs"
+ "Browser Profiles"
],
- "summary": "Get run timeline",
- "description": "Get timeline for a run (workflow run or task_v2 run)",
- "operationId": "get_run_timeline_v1_runs__run_id__timeline_get",
+ "summary": "Update browser profile",
+ "description": "Update a browser profile's name and/or description",
+ "operationId": "update_browser_profile_v1_browser_profiles__profile_id__patch",
"parameters": [
{
- "name": "run_id",
+ "name": "profile_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The id of the workflow run or task_v2 run.",
+ "description": "The ID of the browser profile to update. browser_profile_id starts with `bp_`",
"examples": [
- "wr_123",
- "tsk_v2_123"
+ "bp_123456"
],
- "title": "Run Id"
+ "title": "Profile Id"
},
- "description": "The id of the workflow run or task_v2 run."
+ "description": "The ID of the browser profile to update. browser_profile_id starts with `bp_`"
},
{
"name": "x-api-key",
@@ -2781,26 +2567,32 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/UpdateBrowserProfileRequest"
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully retrieved run timeline",
+ "description": "Successfully updated browser profile",
"content": {
"application/json": {
"schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/WorkflowRunTimeline"
- },
- "title": "Response Get Run Timeline V1 Runs Run Id Timeline Get"
+ "$ref": "#/components/schemas/BrowserProfile"
}
}
}
},
- "400": {
- "description": "Timeline not available for this run type"
- },
"404": {
- "description": "Run not found"
+ "description": "Browser profile not found"
+ },
+ "409": {
+ "description": "Browser profile name already exists"
},
"422": {
"description": "Validation Error",
@@ -2813,142 +2605,43 @@
}
}
},
- "x-fern-sdk-method-name": "get_run_timeline",
+ "x-fern-sdk-method-name": "update_browser_profile",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\n# Get timeline for a workflow run\ntimeline = await skyvern.get_run_timeline(run_id=\"wr_123\")\nprint(timeline)\n\n# Get timeline for a task_v2 run\ntimeline = await skyvern.get_run_timeline(run_id=\"tsk_v2_123\")\nprint(timeline)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_profile = await skyvern.browser_profiles.update_browser_profile(\n \"bp_123\",\n name=\"Renamed Profile\",\n description=\"Updated description\",\n)\nprint(browser_profile)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\n// Get timeline for a workflow run\nconst timeline = await skyvern.getRunTimeline(\"wr_123\");\nconsole.log(timeline);\n\n// Get timeline for a task_v2 run\nconst timeline2 = await skyvern.getRunTimeline(\"tsk_v2_123\");\nconsole.log(timeline2);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserProfile = await skyvern.browserProfiles.updateBrowserProfile(\"bp_123\", {\n name: \"Renamed Profile\",\n description: \"Updated description\",\n});\nconsole.log(browserProfile);\n"
}
]
}
]
- }
- },
- "/v1/version": {
- "get": {
+ },
+ "delete": {
"tags": [
- "Server"
+ "Browser Profiles"
],
- "summary": "Get server version",
- "description": "Returns the current Skyvern server version (git SHA for official builds).",
- "operationId": "get_version_v1_version_get",
- "responses": {
- "200": {
- "description": "Current server version",
- "content": {
- "application/json": {
- "schema": {
- "additionalProperties": {
- "type": "string"
- },
- "type": "object",
- "title": "Response Get Version V1 Version Get"
- }
- }
- }
- }
- },
- "x-fern-sdk-method-name": "get_version"
- }
- },
- "/v1/runs": {
- "get": {
- "tags": [
- "agent"
- ],
- "summary": "Get Runs V2",
- "operationId": "get_runs_v2_v1_runs_get",
+ "summary": "Delete browser profile",
+ "description": "Delete a browser profile (soft delete)",
+ "operationId": "delete_browser_profile_v1_browser_profiles__profile_id__delete",
"parameters": [
{
- "name": "page",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "maximum": 100,
- "minimum": 1,
- "default": 1,
- "title": "Page"
- }
- },
- {
- "name": "page_size",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "maximum": 100,
- "minimum": 1,
- "default": 10,
- "title": "Page Size"
- }
- },
- {
- "name": "status",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/RunStatus"
- }
- },
- {
- "type": "null"
- }
- ],
- "title": "Status"
- }
- },
- {
- "name": "search_key",
- "in": "query",
- "required": false,
+ "name": "profile_id",
+ "in": "path",
+ "required": true,
"schema": {
- "anyOf": [
- {
- "type": "string",
- "minLength": 3
- },
- {
- "type": "null"
- }
- ],
- "description": "Case-insensitive substring search (min 3 chars for trigram index).",
+ "type": "string",
+ "description": "The ID of the browser profile to delete. browser_profile_id starts with `bp_`",
"examples": [
- "login_url",
- "wr_abc123"
+ "bp_123456"
],
- "title": "Search Key"
+ "title": "Profile Id"
},
- "description": "Case-insensitive substring search (min 3 chars for trigram index)."
- },
- {
- "name": "run_type",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/RunType"
- }
- },
- {
- "type": "null"
- }
- ],
- "title": "Run Type"
- }
+ "description": "The ID of the browser profile to delete. browser_profile_id starts with `bp_`"
},
{
"name": "x-api-key",
@@ -2970,19 +2663,11 @@
}
],
"responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/TaskRunListItem"
- },
- "title": "Response Get Runs V2 V1 Runs Get"
- }
- }
- }
+ "204": {
+ "description": "Successfully deleted browser profile"
+ },
+ "404": {
+ "description": "Browser profile not found"
},
"422": {
"description": "Validation Error",
@@ -2995,17 +2680,31 @@
}
}
},
- "x-hidden": true,
- "x-fern-sdk-method-name": "get_runs_v2"
+ "x-fern-sdk-method-name": "delete_browser_profile",
+ "x-fern-examples": [
+ {
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.browser_profiles.delete_browser_profile(\"bp_123\")\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.browserProfiles.deleteBrowserProfile(\"bp_123\");\n"
+ }
+ ]
+ }
+ ]
}
},
- "/v1/upload_file": {
+ "/v1/browser_sessions": {
"post": {
"tags": [
- "Files"
+ "Browser Sessions"
],
- "summary": "Upload File",
- "operationId": "upload_file_v1_upload_file_post",
+ "summary": "Create a session",
+ "description": "Create a browser session that persists across multiple runs",
+ "operationId": "create_browser_session_v1_browser_sessions_post",
"parameters": [
{
"name": "x-api-key",
@@ -3027,26 +2726,35 @@
}
],
"requestBody": {
- "required": true,
"content": {
- "multipart/form-data": {
+ "application/json": {
"schema": {
- "$ref": "#/components/schemas/Body_upload_file_v1_upload_file_post"
+ "$ref": "#/components/schemas/CreateBrowserSessionRequest",
+ "default": {
+ "timeout": 60,
+ "generate_browser_profile": false
+ }
}
}
}
},
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully created browser session",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/UploadFileResponse"
+ "$ref": "#/components/schemas/BrowserSessionResponse"
}
}
}
},
+ "403": {
+ "description": "Unauthorized - Invalid or missing authentication"
+ },
+ "404": {
+ "description": "Browser profile not found"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -3058,17 +2766,29 @@
}
}
},
- "x-fern-sdk-method-name": "upload_file"
- }
- },
- "/v1/browser_profiles": {
- "post": {
+ "x-fern-sdk-method-name": "create_browser_session",
+ "x-fern-examples": [
+ {
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_session = await skyvern.create_browser_session(timeout=60)\nprint(browser_session)\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserSession = await skyvern.createBrowserSession({\n timeout: 60\n});\nconsole.log(browserSession);\n"
+ }
+ ]
+ }
+ ]
+ },
+ "get": {
"tags": [
- "Browser Profiles"
+ "Browser Sessions"
],
- "summary": "Create a browser profile",
- "description": "Create a blank browser profile, or create one from a persistent browser session or workflow run.",
- "operationId": "create_browser_profile_v1_browser_profiles_post",
+ "summary": "Get active browser sessions",
+ "description": "Get all active browser sessions for the organization",
+ "operationId": "get_browser_sessions_v1_browser_sessions_get",
"parameters": [
{
"name": "x-api-key",
@@ -3089,32 +2809,23 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/CreateBrowserProfileRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully created browser profile",
+ "description": "Successfully retrieved all active browser sessions",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/BrowserProfile"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/BrowserSessionResponse"
+ },
+ "title": "Response Get Browser Sessions V1 Browser Sessions Get"
}
}
}
},
- "400": {
- "description": "Invalid request - source not found or source archive unavailable"
- },
- "409": {
- "description": "Browser profile name already exists"
+ "403": {
+ "description": "Unauthorized - Invalid or missing authentication"
},
"422": {
"description": "Validation Error",
@@ -3127,103 +2838,45 @@
}
}
},
- "x-fern-sdk-method-name": "create_browser_profile",
+ "x-fern-sdk-method-name": "get_browser_sessions",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\n# Create a blank browser profile for future runs\nblank_profile = await skyvern.browser_profiles.create_browser_profile(\n name=\"Fresh Profile\",\n)\nprint(blank_profile)\n\n# Create a browser profile from a persistent browser session\nbrowser_profile = await skyvern.browser_profiles.create_browser_profile(\n name=\"My Profile\",\n browser_session_id=\"pbs_123\",\n)\nprint(browser_profile)\n\n# Or create from a workflow run with persist_browser_session=True\nbrowser_profile = await skyvern.browser_profiles.create_browser_profile(\n name=\"My Profile\",\n workflow_run_id=\"wr_123\",\n)\nprint(browser_profile)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_sessions = await skyvern.get_browser_sessions()\nprint(browser_sessions)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\n// Create a blank browser profile for future runs\nconst blankProfile = await skyvern.browserProfiles.createBrowserProfile({\n name: \"Fresh Profile\",\n});\nconsole.log(blankProfile);\n\n// Create a browser profile from a persistent browser session\nconst browserProfile = await skyvern.browserProfiles.createBrowserProfile({\n name: \"My Profile\",\n browser_session_id: \"pbs_123\",\n});\nconsole.log(browserProfile);\n\n// Or create from a workflow run with persist_browser_session=True\nconst browserProfile2 = await skyvern.browserProfiles.createBrowserProfile({\n name: \"My Profile\",\n workflow_run_id: \"wr_123\",\n});\nconsole.log(browserProfile2);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserSessions = await skyvern.getBrowserSessions();\nconsole.log(browserSessions);\n"
}
]
}
]
- },
- "get": {
+ }
+ },
+ "/v1/browser_sessions/{browser_session_id}/close": {
+ "post": {
"tags": [
- "Browser Profiles"
+ "Browser Sessions"
],
- "summary": "List browser profiles",
- "description": "Get all browser profiles for the organization",
- "operationId": "list_browser_profiles_v1_browser_profiles_get",
+ "summary": "Close a session",
+ "description": "Close a session. Once closed, the session cannot be used again.",
+ "operationId": "close_browser_session_v1_browser_sessions__browser_session_id__close_post",
"parameters": [
{
- "name": "page",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "default": 1,
- "title": "Page"
- }
- },
- {
- "name": "page_size",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "default": 10,
- "title": "Page Size"
- }
- },
- {
- "name": "include_deleted",
- "in": "query",
- "required": false,
- "schema": {
- "type": "boolean",
- "description": "Include deleted browser profiles",
- "default": false,
- "title": "Include Deleted"
- },
- "description": "Include deleted browser profiles"
- },
- {
- "name": "search_key",
- "in": "query",
- "required": false,
+ "name": "browser_session_id",
+ "in": "path",
+ "required": true,
"schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.",
+ "type": "string",
+ "description": "The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`",
"examples": [
- "my_profile",
- "production"
- ],
- "title": "Search Key"
- },
- "description": "Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches."
- },
- {
- "name": "managed",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
+ "pbs_123456"
],
- "description": "Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles.",
- "title": "Managed"
+ "title": "Browser Session Id"
},
- "description": "Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles."
+ "description": "The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`"
},
{
"name": "x-api-key",
@@ -3246,19 +2899,16 @@
],
"responses": {
"200": {
- "description": "Successfully retrieved browser profiles",
+ "description": "Successfully closed browser session",
"content": {
"application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/BrowserProfile"
- },
- "title": "Response List Browser Profiles V1 Browser Profiles Get"
- }
+ "schema": {}
}
}
},
+ "403": {
+ "description": "Unauthorized - Invalid or missing authentication"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -3270,45 +2920,45 @@
}
}
},
- "x-fern-sdk-method-name": "list_browser_profiles",
+ "x-fern-sdk-method-name": "close_browser_session",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_profiles = await skyvern.browser_profiles.list_browser_profiles()\nprint(browser_profiles)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.close_browser_session(browser_session_id=\"pbs_123\")\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserProfiles = await skyvern.browserProfiles.listBrowserProfiles();\nconsole.log(browserProfiles);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.closeBrowserSession(\"pbs_123\");\n"
}
]
}
]
}
},
- "/v1/browser_profiles/{profile_id}": {
- "get": {
+ "/v1/browser_sessions/{browser_session_id}": {
+ "patch": {
"tags": [
- "Browser Profiles"
+ "Browser Sessions"
],
- "summary": "Get browser profile",
- "description": "Get a specific browser profile by ID",
- "operationId": "get_browser_profile_v1_browser_profiles__profile_id__get",
+ "summary": "Update a session",
+ "description": "Update a live browser session. Currently supports toggling generate_browser_profile, which is read when the session ends to decide whether to save its browser profile.",
+ "operationId": "update_browser_session_v1_browser_sessions__browser_session_id__patch",
"parameters": [
{
- "name": "profile_id",
+ "name": "browser_session_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The ID of the browser profile. browser_profile_id starts with `bp_`",
+ "description": "The ID of the browser session. browser_session_id starts with `pbs_`",
"examples": [
- "bp_123456"
+ "pbs_123456"
],
- "title": "Profile Id"
+ "title": "Browser Session Id"
},
- "description": "The ID of the browser profile. browser_profile_id starts with `bp_`"
+ "description": "The ID of the browser session. browser_session_id starts with `pbs_`"
},
{
"name": "x-api-key",
@@ -3329,19 +2979,35 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/UpdateBrowserSessionRequest"
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully retrieved browser profile",
+ "description": "Successfully updated browser session",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/BrowserProfile"
+ "$ref": "#/components/schemas/BrowserSessionResponse"
}
}
}
},
"404": {
- "description": "Browser profile not found"
+ "description": "Browser session not found"
+ },
+ "403": {
+ "description": "Unauthorized - Invalid or missing authentication"
+ },
+ "409": {
+ "description": "Conflict - browser session has already ended and can no longer be updated"
},
"422": {
"description": "Validation Error",
@@ -3354,43 +3020,29 @@
}
}
},
- "x-fern-sdk-method-name": "get_browser_profile",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_profile = await skyvern.browser_profiles.get_browser_profile(\"bp_123\")\nprint(browser_profile)\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserProfile = await skyvern.browserProfiles.getBrowserProfile(\"bp_123\");\nconsole.log(browserProfile);\n"
- }
- ]
- }
- ]
+ "x-fern-sdk-method-name": "update_browser_session"
},
- "patch": {
+ "get": {
"tags": [
- "Browser Profiles"
+ "Browser Sessions"
],
- "summary": "Update browser profile",
- "description": "Update a browser profile's name and/or description",
- "operationId": "update_browser_profile_v1_browser_profiles__profile_id__patch",
+ "summary": "Get a session",
+ "description": "Get details about a specific browser session, including the browser address for cdp connection.",
+ "operationId": "get_browser_session_v1_browser_sessions__browser_session_id__get",
"parameters": [
{
- "name": "profile_id",
+ "name": "browser_session_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The ID of the browser profile to update. browser_profile_id starts with `bp_`",
+ "description": "The ID of the browser session. browser_session_id starts with `pbs_`",
"examples": [
- "bp_123456"
+ "pbs_123456"
],
- "title": "Profile Id"
+ "title": "Browser Session Id"
},
- "description": "The ID of the browser profile to update. browser_profile_id starts with `bp_`"
+ "description": "The ID of the browser session. browser_session_id starts with `pbs_`"
},
{
"name": "x-api-key",
@@ -3411,32 +3063,22 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/UpdateBrowserProfileRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully updated browser profile",
+ "description": "Successfully retrieved browser session details",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/BrowserProfile"
+ "$ref": "#/components/schemas/BrowserSessionResponse"
}
}
}
},
"404": {
- "description": "Browser profile not found"
+ "description": "Browser session not found"
},
- "409": {
- "description": "Browser profile name already exists"
+ "403": {
+ "description": "Unauthorized - Invalid or missing authentication"
},
"422": {
"description": "Validation Error",
@@ -3449,44 +3091,32 @@
}
}
},
- "x-fern-sdk-method-name": "update_browser_profile",
+ "x-fern-sdk-method-name": "get_browser_session",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_profile = await skyvern.browser_profiles.update_browser_profile(\n \"bp_123\",\n name=\"Renamed Profile\",\n description=\"Updated description\",\n)\nprint(browser_profile)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_session = await skyvern.get_browser_session(browser_session_id=\"pbs_123\")\nprint(browser_session)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserProfile = await skyvern.browserProfiles.updateBrowserProfile(\"bp_123\", {\n name: \"Renamed Profile\",\n description: \"Updated description\",\n});\nconsole.log(browserProfile);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserSession = await skyvern.getBrowserSession(\"pbs_123\");\nconsole.log(browserSession);\n"
}
]
}
]
- },
- "delete": {
+ }
+ },
+ "/v1/credentials/totp": {
+ "post": {
"tags": [
- "Browser Profiles"
+ "Credentials"
],
- "summary": "Delete browser profile",
- "description": "Delete a browser profile (soft delete)",
- "operationId": "delete_browser_profile_v1_browser_profiles__profile_id__delete",
+ "summary": "Send TOTP code",
+ "description": "Forward a TOTP (2FA, MFA) email or sms message containing the code to Skyvern. This endpoint stores the code in database so that Skyvern can use it while running tasks/workflows.",
+ "operationId": "send_totp_code_v1_credentials_totp_post",
"parameters": [
- {
- "name": "profile_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "The ID of the browser profile to delete. browser_profile_id starts with `bp_`",
- "examples": [
- "bp_123456"
- ],
- "title": "Profile Id"
- },
- "description": "The ID of the browser profile to delete. browser_profile_id starts with `bp_`"
- },
{
"name": "x-api-key",
"in": "header",
@@ -3506,12 +3136,26 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TOTPCodeCreate"
+ }
+ }
+ }
+ },
"responses": {
- "204": {
- "description": "Successfully deleted browser profile"
- },
- "404": {
- "description": "Browser profile not found"
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TOTPCode"
+ }
+ }
+ }
},
"422": {
"description": "Validation Error",
@@ -3524,31 +3168,31 @@
}
}
},
- "x-fern-sdk-method-name": "delete_browser_profile",
+ "x-fern-sdk-method-name": "send_totp_code",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.browser_profiles.delete_browser_profile(\"bp_123\")\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.send_totp_code(\n totp_identifier=\"[email protected]\",\n content=\"Hello, your verification code is 123456\"\n)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.browserProfiles.deleteBrowserProfile(\"bp_123\");\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.sendTotpCode({\n totp_identifier: \"[email protected]\",\n content: \"Hello, your verification code is 123456\"\n});\n"
}
]
}
]
}
},
- "/v1/browser_sessions": {
+ "/v1/credentials": {
"post": {
"tags": [
- "Browser Sessions"
+ "Credentials"
],
- "summary": "Create a session",
- "description": "Create a browser session that persists across multiple runs",
- "operationId": "create_browser_session_v1_browser_sessions_post",
+ "summary": "Create credential",
+ "description": "Creates a new credential for the current organization",
+ "operationId": "create_credential_v1_credentials_post",
"parameters": [
{
"name": "x-api-key",
@@ -3570,35 +3214,41 @@
}
],
"requestBody": {
+ "required": true,
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CreateBrowserSessionRequest",
- "default": {
- "timeout": 60,
- "generate_browser_profile": false
+ "$ref": "#/components/schemas/CreateCredentialRequest",
+ "description": "The credential data to create",
+ "examples": [
+ {
+ "name": "My Credential",
+ "credential_type": "PASSWORD",
+ "credential": {
+ "username": "[email protected]",
+ "password": "securepassword123",
+ "totp": "JBSWY3DPEHPK3PXP"
+ }
+ }
+ ],
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "data"
}
}
}
}
},
"responses": {
- "200": {
- "description": "Successfully created browser session",
+ "201": {
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/BrowserSessionResponse"
+ "$ref": "#/components/schemas/CredentialResponse"
}
}
}
},
- "403": {
- "description": "Unauthorized - Invalid or missing authentication"
- },
- "404": {
- "description": "Browser profile not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -3610,17 +3260,25 @@
}
}
},
- "x-fern-sdk-method-name": "create_browser_session",
+ "x-fern-sdk-method-name": "create_credential",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_session = await skyvern.create_browser_session(timeout=60)\nprint(browser_session)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.create_credential(\n name=\"My Credential\",\n credential_type=\"password\",\n credential={\"username\": \"username\", \"password\": \"password\"},\n)\n"
+ },
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.create_credential(\n name=\"My Credit Card\",\n credential_type=\"credit_card\",\n credential={\n \"card_number\": \"4242424242424242\",\n \"card_cvv\": \"424\",\n \"card_exp_month\": \"12\",\n \"card_exp_year\": \"2028\",\n \"card_brand\": \"visa\",\n \"card_holder_name\": \"John Doe\",\n },\n)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserSession = await skyvern.createBrowserSession({\n timeout: 60\n});\nconsole.log(browserSession);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.createCredential({\n name: \"My Credential\",\n credential_type: \"password\",\n credential: { username: \"username\", password: \"password\" }\n});\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.createCredential({\n name: \"My Credit Card\",\n credential_type: \"credit_card\",\n credential: {\n card_number: \"4242424242424242\",\n card_cvv: \"424\",\n card_exp_month: \"12\",\n card_exp_year: \"2028\",\n card_brand: \"visa\",\n card_holder_name: \"John Doe\"\n }\n});\n"
}
]
}
@@ -3628,12 +3286,105 @@
},
"get": {
"tags": [
- "Browser Sessions"
+ "Credentials"
],
- "summary": "Get active browser sessions",
- "description": "Get all active browser sessions for the organization",
- "operationId": "get_browser_sessions_v1_browser_sessions_get",
+ "summary": "Get all credentials",
+ "description": "Retrieves a paginated list of credentials for the current organization",
+ "operationId": "get_credentials_v1_credentials_get",
"parameters": [
+ {
+ "name": "page",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "Page number for pagination",
+ "examples": [
+ 1
+ ],
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "page"
+ },
+ "default": 1,
+ "title": "Page"
+ },
+ "description": "Page number for pagination"
+ },
+ {
+ "name": "page_size",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "Number of items per page",
+ "examples": [
+ 10
+ ],
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "page_size"
+ },
+ "default": 10,
+ "title": "Page Size"
+ },
+ "description": "Number of items per page"
+ },
+ {
+ "name": "vault_type",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "$ref": "#/components/schemas/CredentialVaultType"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')",
+ "title": "Vault Type"
+ },
+ "description": "Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')"
+ },
+ {
+ "name": "credential_type",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "$ref": "#/components/schemas/skyvern__forge__sdk__schemas__credentials__CredentialType"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Filter credentials by type (e.g. 'password', 'credit_card', 'secret')",
+ "title": "Credential Type"
+ },
+ "description": "Filter credentials by type (e.g. 'password', 'credit_card', 'secret')"
+ },
+ {
+ "name": "search",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string",
+ "maxLength": 200
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Case-insensitive search across credential name, username, secret label, and card details",
+ "title": "Search"
+ },
+ "description": "Case-insensitive search across credential name, username, secret label, and card details"
+ },
{
"name": "x-api-key",
"in": "header",
@@ -3655,22 +3406,19 @@
],
"responses": {
"200": {
- "description": "Successfully retrieved all active browser sessions",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
- "$ref": "#/components/schemas/BrowserSessionResponse"
+ "$ref": "#/components/schemas/CredentialResponse"
},
- "title": "Response Get Browser Sessions V1 Browser Sessions Get"
+ "title": "Response Get Credentials V1 Credentials Get"
}
}
}
},
- "403": {
- "description": "Unauthorized - Invalid or missing authentication"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -3682,45 +3430,48 @@
}
}
},
- "x-fern-sdk-method-name": "get_browser_sessions",
+ "x-fern-sdk-method-name": "get_credentials",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_sessions = await skyvern.get_browser_sessions()\nprint(browser_sessions)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\ncredentials = await skyvern.get_credentials()\nprint(credentials)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserSessions = await skyvern.getBrowserSessions();\nconsole.log(browserSessions);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst credentials = await skyvern.getCredentials();\nconsole.log(credentials);\n"
}
]
}
]
}
},
- "/v1/browser_sessions/{browser_session_id}/close": {
+ "/v1/credentials/{credential_id}/update": {
"post": {
"tags": [
- "Browser Sessions"
+ "Credentials"
],
- "summary": "Close a session",
- "description": "Close a session. Once closed, the session cannot be used again.",
- "operationId": "close_browser_session_v1_browser_sessions__browser_session_id__close_post",
+ "summary": "Update credential",
+ "description": "Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.",
+ "operationId": "update_credential_v1_credentials__credential_id__update_post",
"parameters": [
{
- "name": "browser_session_id",
+ "name": "credential_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`",
+ "description": "The unique identifier of the credential to update",
"examples": [
- "pbs_123456"
+ "cred_1234567890"
],
- "title": "Browser Session Id"
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "credential_id"
+ },
+ "title": "Credential Id"
},
- "description": "The ID of the browser session to close. completed_at will be set when the browser session is closed. browser_session_id starts with `pbs_`"
+ "description": "The unique identifier of the credential to update"
},
{
"name": "x-api-key",
@@ -3741,21 +3492,41 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/CreateCredentialRequest",
+ "description": "The new credential data to store",
+ "examples": [
+ {
+ "name": "My Credential",
+ "credential_type": "PASSWORD",
+ "credential": {
+ "username": "[email protected]",
+ "password": "newpassword123"
+ }
+ }
+ ],
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "data"
+ }
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully closed browser session",
+ "description": "Successful Response",
"content": {
"application/json": {
- "schema": {}
+ "schema": {
+ "$ref": "#/components/schemas/CredentialResponse"
+ }
}
}
},
- "403": {
- "description": "Unauthorized - Invalid or missing authentication"
- },
- "404": {
- "description": "Browser session not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -3767,45 +3538,48 @@
}
}
},
- "x-fern-sdk-method-name": "close_browser_session",
+ "x-fern-sdk-method-name": "update_credential",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.close_browser_session(browser_session_id=\"pbs_123\")\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nupdated = await skyvern.update_credential(\n credential_id=\"cred_123\",\n name=\"My Credential\",\n credential_type=\"password\",\n credential={\"username\": \"[email protected]\", \"password\": \"newpassword123\"},\n)\nprint(updated)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.closeBrowserSession(\"pbs_123\");\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst updated = await skyvern.updateCredential(\"cred_123\", {\n name: \"My Credential\",\n credential_type: \"password\",\n credential: { username: \"[email protected]\", password: \"newpassword123\" }\n});\nconsole.log(updated);\n"
}
]
}
]
}
},
- "/v1/browser_sessions/{browser_session_id}": {
- "patch": {
+ "/v1/credentials/{credential_id}/delete": {
+ "post": {
"tags": [
- "Browser Sessions"
+ "Credentials"
],
- "summary": "Update a session",
- "description": "Update a live browser session. Currently supports toggling generate_browser_profile, which is read when the session ends to decide whether to save its browser profile.",
- "operationId": "update_browser_session_v1_browser_sessions__browser_session_id__patch",
+ "summary": "Delete credential",
+ "description": "Deletes a specific credential by its ID",
+ "operationId": "delete_credential_v1_credentials__credential_id__delete_post",
"parameters": [
{
- "name": "browser_session_id",
+ "name": "credential_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The ID of the browser session. browser_session_id starts with `pbs_`",
+ "description": "The unique identifier of the credential to delete",
"examples": [
- "pbs_123456"
+ "cred_1234567890"
],
- "title": "Browser Session Id"
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "credential_id"
+ },
+ "title": "Credential Id"
},
- "description": "The ID of the browser session. browser_session_id starts with `pbs_`"
+ "description": "The unique identifier of the credential to delete"
},
{
"name": "x-api-key",
@@ -3826,35 +3600,9 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/UpdateBrowserSessionRequest"
- }
- }
- }
- },
"responses": {
- "200": {
- "description": "Successfully updated browser session",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/BrowserSessionResponse"
- }
- }
- }
- },
- "403": {
- "description": "Unauthorized - Invalid or missing authentication"
- },
- "404": {
- "description": "Browser session not found"
- },
- "409": {
- "description": "Conflict - browser session has already ended and can no longer be updated"
+ "204": {
+ "description": "Successful Response"
},
"422": {
"description": "Validation Error",
@@ -3867,29 +3615,48 @@
}
}
},
- "x-fern-sdk-method-name": "update_browser_session"
- },
+ "x-fern-sdk-method-name": "delete_credential",
+ "x-fern-examples": [
+ {
+ "code-samples": [
+ {
+ "sdk": "python",
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.delete_credential(credential_id=\"cred_123\")\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.deleteCredential(\"cred_123\");\n"
+ }
+ ]
+ }
+ ]
+ }
+ },
+ "/v1/credentials/{credential_id}": {
"get": {
"tags": [
- "Browser Sessions"
+ "Credentials"
],
- "summary": "Get a session",
- "description": "Get details about a specific browser session, including the browser address for cdp connection.",
- "operationId": "get_browser_session_v1_browser_sessions__browser_session_id__get",
+ "summary": "Get credential by ID",
+ "description": "Retrieves a specific credential by its ID",
+ "operationId": "get_credential_v1_credentials__credential_id__get",
"parameters": [
{
- "name": "browser_session_id",
+ "name": "credential_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The ID of the browser session. browser_session_id starts with `pbs_`",
+ "description": "The unique identifier of the credential",
"examples": [
- "pbs_123456"
+ "cred_1234567890"
],
- "title": "Browser Session Id"
+ "openapi_extra": {
+ "x-fern-sdk-parameter-name": "credential_id"
+ },
+ "title": "Credential Id"
},
- "description": "The ID of the browser session. browser_session_id starts with `pbs_`"
+ "description": "The unique identifier of the credential"
},
{
"name": "x-api-key",
@@ -3912,21 +3679,15 @@
],
"responses": {
"200": {
- "description": "Successfully retrieved browser session details",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/BrowserSessionResponse"
+ "$ref": "#/components/schemas/CredentialResponse"
}
}
}
},
- "403": {
- "description": "Unauthorized - Invalid or missing authentication"
- },
- "404": {
- "description": "Browser session not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -3938,31 +3699,31 @@
}
}
},
- "x-fern-sdk-method-name": "get_browser_session",
+ "x-fern-sdk-method-name": "get_credential",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nbrowser_session = await skyvern.get_browser_session(browser_session_id=\"pbs_123\")\nprint(browser_session)\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\ncredential = await skyvern.get_credential(credential_id=\"cred_123\")\nprint(credential)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst browserSession = await skyvern.getBrowserSession(\"pbs_123\");\nconsole.log(browserSession);\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst credential = await skyvern.getCredential(\"cred_123\");\nconsole.log(credential);\n"
}
]
}
]
}
},
- "/v1/credentials/totp": {
+ "/v1/run/tasks/login": {
"post": {
"tags": [
- "Credentials"
+ "Agents"
],
- "summary": "Send TOTP code",
- "description": "Forward a TOTP (2FA, MFA) email or sms message containing the code to Skyvern. This endpoint stores the code in database so that Skyvern can use it while running tasks/workflows.",
- "operationId": "send_totp_code_v1_credentials_totp_post",
+ "summary": "Login Task",
+ "description": "Log in to a website using either credential stored in Skyvern, Bitwarden, 1Password, or Azure Vault",
+ "operationId": "login_v1_run_tasks_login_post",
"parameters": [
{
"name": "x-api-key",
@@ -3981,6 +3742,22 @@
"title": "X-Api-Key"
},
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
+ },
+ {
+ "name": "x-user-agent",
+ "in": "header",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "X-User-Agent"
+ }
}
],
"requestBody": {
@@ -3988,7 +3765,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TOTPCodeCreate"
+ "$ref": "#/components/schemas/LoginRequest"
}
}
}
@@ -3999,7 +3776,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TOTPCode"
+ "$ref": "#/components/schemas/WorkflowRunResponse"
}
}
}
@@ -4015,31 +3792,49 @@
}
}
},
- "x-fern-sdk-method-name": "send_totp_code",
+ "x-hidden": true,
+ "x-excluded": true,
+ "x-fern-sdk-method-name": "login",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.send_totp_code(\n totp_identifier=\"[email protected]\",\n content=\"Hello, your verification code is 123456\"\n)\n"
+ "code": "# Login with password saved in Skyvern\nfrom skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"skyvern\",\n credential_id=\"cred_123\"),\n)\n"
+ },
+ {
+ "sdk": "python",
+ "code": "# Login with password saved in Bitwarden\nfrom skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\n# Login with a Bitwarden collection and website url filter\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"bitwarden\",\n bitwarden_collection_id=\"BITWARDEN COLLECTION ID\",\n)\n\n# Login with a Bitwarden item\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"bitwarden\",\n bitwarden_item_id=\"BITWARDEN ITEM ID\",\n)\n"
+ },
+ {
+ "sdk": "python",
+ "code": "# Login with password saved in 1Password\nfrom skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"onepassword\",\n onepassword_vault_id=\"1PASSWORD VAULT ID\",\n onepassword_item_id=\"1PASSWORD ITEM ID\",\n)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.sendTotpCode({\n totp_identifier: \"[email protected]\",\n content: \"Hello, your verification code is 123456\"\n});\n"
+ "code": "// Login with password saved in Skyvern\nimport { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"skyvern\",\n credential_id: \"cred_123\"\n});\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "// Login with password saved in Bitwarden\nimport { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\n// Login with a Bitwarden collection and website url filter\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"bitwarden\",\n bitwarden_collection_id: \"BITWARDEN COLLECTION ID\"\n});\n\n// Login with a Bitwarden item\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"bitwarden\",\n bitwarden_item_id: \"BITWARDEN ITEM ID\"\n});\n"
+ },
+ {
+ "sdk": "typescript",
+ "code": "// Login with password saved in 1Password\nimport { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"onepassword\",\n onepassword_vault_id: \"1PASSWORD VAULT ID\",\n onepassword_item_id: \"1PASSWORD ITEM ID\"\n});\n"
}
]
}
]
}
},
- "/v1/credentials": {
+ "/v1/run/tasks/download_files": {
"post": {
"tags": [
- "Credentials"
+ "Agents"
],
- "summary": "Create credential",
- "description": "Creates a new credential for the current organization",
- "operationId": "create_credential_v1_credentials_post",
+ "summary": "File Download Task",
+ "description": "Download a file from a website by navigating and clicking download buttons",
+ "operationId": "download_files_v1_run_tasks_download_files_post",
"parameters": [
{
"name": "x-api-key",
@@ -4058,6 +3853,22 @@
"title": "X-Api-Key"
},
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
+ },
+ {
+ "name": "x-user-agent",
+ "in": "header",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "X-User-Agent"
+ }
}
],
"requestBody": {
@@ -4065,33 +3876,18 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CreateCredentialRequest",
- "description": "The credential data to create",
- "examples": [
- {
- "name": "My Credential",
- "credential_type": "PASSWORD",
- "credential": {
- "username": "[email protected]",
- "password": "securepassword123",
- "totp": "JBSWY3DPEHPK3PXP"
- }
- }
- ],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "data"
- }
+ "$ref": "#/components/schemas/DownloadFilesRequest"
}
}
}
},
"responses": {
- "201": {
+ "200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CredentialResponse"
+ "$ref": "#/components/schemas/WorkflowRunResponse"
}
}
}
@@ -4107,130 +3903,126 @@
}
}
},
- "x-fern-sdk-method-name": "create_credential",
+ "x-hidden": true,
+ "x-excluded": true,
+ "x-fern-sdk-method-name": "download_files",
"x-fern-examples": [
{
"code-samples": [
{
"sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.create_credential(\n name=\"My Credential\",\n credential_type=\"password\",\n credential={\"username\": \"username\", \"password\": \"password\"},\n)\n"
- },
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.create_credential(\n name=\"My Credit Card\",\n credential_type=\"credit_card\",\n credential={\n \"card_number\": \"4242424242424242\",\n \"card_cvv\": \"424\",\n \"card_exp_month\": \"12\",\n \"card_exp_year\": \"2028\",\n \"card_brand\": \"visa\",\n \"card_holder_name\": \"John Doe\",\n \"billing_address\": {\n \"line1\": \"123 Main St\",\n \"city\": \"San Francisco\",\n \"state_code\": \"CA\",\n \"postal_code\": \"94105\",\n \"country_code\": \"US\",\n },\n \"billing_email\": \"[email protected]\",\n \"metadata\": {\"checkout_profile\": \"default\"},\n },\n)\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.createCredential({\n name: \"My Credential\",\n credential_type: \"password\",\n credential: { username: \"username\", password: \"password\" }\n});\n"
+ "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.download_files(\n url=\"https://example.com/downloads\",\n navigation_goal=\"Navigate to the downloads page and click the 'Download PDF' button\",\n download_suffix=\"report.pdf\"\n)\n"
},
{
"sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.createCredential({\n name: \"My Credit Card\",\n credential_type: \"credit_card\",\n credential: {\n card_number: \"4242424242424242\",\n card_cvv: \"424\",\n card_exp_month: \"12\",\n card_exp_year: \"2028\",\n card_brand: \"visa\",\n card_holder_name: \"John Doe\",\n billing_address: {\n line1: \"123 Main St\",\n city: \"San Francisco\",\n state_code: \"CA\",\n postal_code: \"94105\",\n country_code: \"US\",\n },\n billing_email: \"[email protected]\",\n metadata: { checkout_profile: \"default\" }\n }\n});\n"
+ "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.downloadFiles({\n url: \"https://example.com/downloads\",\n navigation_goal: \"Navigate to the downloads page and click the 'Download PDF' button\",\n download_suffix: \"report.pdf\"\n});\n"
}
]
}
]
- },
- "get": {
+ }
+ },
+ "/v1/scripts": {
+ "post": {
"tags": [
- "Credentials"
+ "Scripts"
],
- "summary": "Get all credentials",
- "description": "Retrieves a paginated list of credentials for the current organization",
- "operationId": "get_credentials_v1_credentials_get",
+ "summary": "Create script",
+ "description": "Create a new script with optional files and metadata",
+ "operationId": "create_script_v1_scripts_post",
"parameters": [
{
- "name": "page",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "description": "Page number for pagination",
- "examples": [
- 1
- ],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "page"
- },
- "default": 1,
- "title": "Page"
- },
- "description": "Page number for pagination"
- },
- {
- "name": "page_size",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "description": "Number of items per page",
- "examples": [
- 10
- ],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "page_size"
- },
- "default": 10,
- "title": "Page Size"
- },
- "description": "Number of items per page"
- },
- {
- "name": "vault_type",
- "in": "query",
+ "name": "x-api-key",
+ "in": "header",
"required": false,
"schema": {
"anyOf": [
{
- "$ref": "#/components/schemas/CredentialVaultType"
+ "type": "string"
},
{
"type": "null"
}
],
- "description": "Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')",
- "title": "Vault Type"
+ "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
+ "title": "X-Api-Key"
},
- "description": "Filter credentials by vault type (e.g. 'skyvern', 'custom', 'bitwarden', 'azure_vault')"
+ "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/CreateScriptRequest"
+ }
+ }
+ }
+ },
+ "responses": {
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/CreateScriptResponse"
+ }
+ }
+ }
},
+ "422": {
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ }
+ }
+ },
+ "x-fern-sdk-method-name": "create_script"
+ },
+ "get": {
+ "tags": [
+ "Scripts"
+ ],
+ "summary": "Get all scripts",
+ "description": "Retrieves a paginated list of scripts for the current organization",
+ "operationId": "get_scripts_v1_scripts_get",
+ "parameters": [
{
- "name": "credential_type",
+ "name": "page",
"in": "query",
"required": false,
"schema": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/skyvern__forge__sdk__schemas__credentials__CredentialType"
- },
- {
- "type": "null"
- }
+ "type": "integer",
+ "minimum": 1,
+ "description": "Page number for pagination",
+ "examples": [
+ 1
],
- "description": "Filter credentials by type (e.g. 'password', 'credit_card', 'secret')",
- "title": "Credential Type"
+ "default": 1,
+ "title": "Page"
},
- "description": "Filter credentials by type (e.g. 'password', 'credit_card', 'secret')"
+ "description": "Page number for pagination"
},
{
- "name": "search",
+ "name": "page_size",
"in": "query",
"required": false,
"schema": {
- "anyOf": [
- {
- "type": "string",
- "maxLength": 200
- },
- {
- "type": "null"
- }
+ "type": "integer",
+ "minimum": 1,
+ "description": "Number of items per page",
+ "examples": [
+ 10
],
- "description": "Case-insensitive search across credential name, username, secret label, and card details",
- "title": "Search"
+ "default": 10,
+ "title": "Page Size"
},
- "description": "Case-insensitive search across credential name, username, secret label, and card details"
+ "description": "Number of items per page"
},
{
"name": "x-api-key",
@@ -4259,9 +4051,9 @@
"schema": {
"type": "array",
"items": {
- "$ref": "#/components/schemas/CredentialResponse"
+ "$ref": "#/components/schemas/Script"
},
- "title": "Response Get Credentials V1 Credentials Get"
+ "title": "Response Get Scripts V1 Scripts Get"
}
}
}
@@ -4277,48 +4069,31 @@
}
}
},
- "x-fern-sdk-method-name": "get_credentials",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\ncredentials = await skyvern.get_credentials()\nprint(credentials)\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst credentials = await skyvern.getCredentials();\nconsole.log(credentials);\n"
- }
- ]
- }
- ]
+ "x-fern-sdk-method-name": "get_scripts"
}
},
- "/v1/credentials/{credential_id}/update": {
- "post": {
+ "/v1/scripts/{script_id}": {
+ "get": {
"tags": [
- "Credentials"
+ "Scripts"
],
- "summary": "Update credential",
- "description": "Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.",
- "operationId": "update_credential_v1_credentials__credential_id__update_post",
+ "summary": "Get script by ID",
+ "description": "Retrieves a specific script by its ID",
+ "operationId": "get_script_v1_scripts__script_id__get",
"parameters": [
{
- "name": "credential_id",
+ "name": "script_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The unique identifier of the credential to update",
+ "description": "The unique identifier of the script",
"examples": [
- "cred_1234567890"
+ "s_abc123"
],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "credential_id"
- },
- "title": "Credential Id"
+ "title": "Script Id"
},
- "description": "The unique identifier of the credential to update"
+ "description": "The unique identifier of the script"
},
{
"name": "x-api-key",
@@ -4339,37 +4114,13 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/CreateCredentialRequest",
- "description": "The new credential data to store",
- "examples": [
- {
- "name": "My Credential",
- "credential_type": "PASSWORD",
- "credential": {
- "username": "[email protected]",
- "password": "newpassword123"
- }
- }
- ],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "data"
- }
- }
- }
- }
- },
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CredentialResponse"
+ "$ref": "#/components/schemas/Script"
}
}
}
@@ -4385,48 +4136,31 @@
}
}
},
- "x-fern-sdk-method-name": "update_credential",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nupdated = await skyvern.update_credential(\n credential_id=\"cred_123\",\n name=\"My Credential\",\n credential_type=\"password\",\n credential={\"username\": \"[email protected]\", \"password\": \"newpassword123\"},\n)\nprint(updated)\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst updated = await skyvern.updateCredential(\"cred_123\", {\n name: \"My Credential\",\n credential_type: \"password\",\n credential: { username: \"[email protected]\", password: \"newpassword123\" }\n});\nconsole.log(updated);\n"
- }
- ]
- }
- ]
+ "x-fern-sdk-method-name": "get_script"
}
},
- "/v1/credentials/{credential_id}/delete": {
+ "/v1/scripts/{script_id}/deploy": {
"post": {
"tags": [
- "Credentials"
+ "Scripts"
],
- "summary": "Delete credential",
- "description": "Deletes a specific credential by its ID",
- "operationId": "delete_credential_v1_credentials__credential_id__delete_post",
+ "summary": "Deploy script",
+ "description": "Deploy a script with updated files, creating a new version",
+ "operationId": "deploy_script_v1_scripts__script_id__deploy_post",
"parameters": [
{
- "name": "credential_id",
+ "name": "script_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The unique identifier of the credential to delete",
+ "description": "The unique identifier of the script",
"examples": [
- "cred_1234567890"
+ "s_abc123"
],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "credential_id"
- },
- "title": "Credential Id"
+ "title": "Script Id"
},
- "description": "The unique identifier of the credential to delete"
+ "description": "The unique identifier of the script"
},
{
"name": "x-api-key",
@@ -4447,9 +4181,26 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/DeployScriptRequest"
+ }
+ }
+ }
+ },
"responses": {
- "204": {
- "description": "Successful Response"
+ "200": {
+ "description": "Successful Response",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/CreateScriptResponse"
+ }
+ }
+ }
},
"422": {
"description": "Validation Error",
@@ -4462,48 +4213,31 @@
}
}
},
- "x-fern-sdk-method-name": "delete_credential",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.delete_credential(credential_id=\"cred_123\")\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.deleteCredential(\"cred_123\");\n"
- }
- ]
- }
- ]
+ "x-fern-sdk-method-name": "deploy_script"
}
},
- "/v1/credentials/{credential_id}": {
- "get": {
+ "/v1/scripts/{script_id}/run": {
+ "post": {
"tags": [
- "Credentials"
+ "Scripts"
],
- "summary": "Get credential by ID",
- "description": "Retrieves a specific credential by its ID",
- "operationId": "get_credential_v1_credentials__credential_id__get",
+ "summary": "Run script",
+ "description": "Run a script",
+ "operationId": "run_script_v1_scripts__script_id__run_post",
"parameters": [
{
- "name": "credential_id",
+ "name": "script_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The unique identifier of the credential",
+ "description": "The unique identifier of the script",
"examples": [
- "cred_1234567890"
+ "s_abc123"
],
- "openapi_extra": {
- "x-fern-sdk-parameter-name": "credential_id"
- },
- "title": "Credential Id"
+ "title": "Script Id"
},
- "description": "The unique identifier of the credential"
+ "description": "The unique identifier of the script"
},
{
"name": "x-api-key",
@@ -4529,9 +4263,7 @@
"description": "Successful Response",
"content": {
"application/json": {
- "schema": {
- "$ref": "#/components/schemas/CredentialResponse"
- }
+ "schema": {}
}
}
},
@@ -4545,32 +4277,17 @@
}
}
}
- },
- "x-fern-sdk-method-name": "get_credential",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\ncredential = await skyvern.get_credential(credential_id=\"cred_123\")\nprint(credential)\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nconst credential = await skyvern.getCredential(\"cred_123\");\nconsole.log(credential);\n"
- }
- ]
- }
- ]
+ }
}
},
- "/v1/custom-llms": {
- "get": {
+ "/v1/sdk/run_action": {
+ "post": {
"tags": [
- "Custom LLMs"
+ "SDK"
],
- "summary": "List Custom LLMs",
- "description": "List the custom LLM configurations available to the current organization.",
- "operationId": "list_custom_llms_v1_custom_llms_get",
+ "summary": "Run an SDK action",
+ "description": "Execute a single SDK action with the specified parameters",
+ "operationId": "run_sdk_action_v1_sdk_run_action_post",
"parameters": [
{
"name": "x-api-key",
@@ -4591,13 +4308,23 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/RunSdkActionRequest"
+ }
+ }
+ }
+ },
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CustomLLMListResponse"
+ "$ref": "#/components/schemas/RunSdkActionResponse"
}
}
}
@@ -4613,16 +4340,81 @@
}
}
},
- "x-fern-sdk-method-name": "list_custom_llms"
- },
- "post": {
+ "x-excluded": true,
+ "x-fern-sdk-method-name": "run_sdk_action"
+ }
+ },
+ "/v1/schedules": {
+ "get": {
"tags": [
- "Custom LLMs"
+ "Schedules"
],
- "summary": "Create Custom LLM",
- "description": "Create a custom LLM configuration for the current organization.",
- "operationId": "create_custom_llm_v1_custom_llms_post",
+ "summary": "List all schedules for the organization",
+ "operationId": "schedules_list_all",
"parameters": [
+ {
+ "name": "page",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "minimum": 1,
+ "default": 1,
+ "title": "Page"
+ }
+ },
+ {
+ "name": "page_size",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "maximum": 100,
+ "minimum": 1,
+ "default": 10,
+ "title": "Page Size"
+ }
+ },
+ {
+ "name": "status",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "enum": [
+ "active",
+ "paused"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Filter by status: 'active' or 'paused'",
+ "title": "Status"
+ },
+ "description": "Filter by status: 'active' or 'paused'"
+ },
+ {
+ "name": "search",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Search by workflow title or schedule name",
+ "title": "Search"
+ },
+ "description": "Search by workflow title or schedule name"
+ },
{
"name": "x-api-key",
"in": "header",
@@ -4642,23 +4434,13 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/CustomLLMCreateRequest"
- }
- }
- }
- },
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CustomLLMResponse"
+ "$ref": "#/components/schemas/OrganizationScheduleListResponse"
}
}
}
@@ -4673,29 +4455,31 @@
}
}
}
- },
- "x-fern-sdk-method-name": "create_custom_llm"
+ }
}
},
- "/v1/custom-llms/{custom_llm_id}": {
+ "/v1/agents/{workflow_permanent_id}/folder": {
"put": {
"tags": [
- "Custom LLMs"
+ "Folders"
],
- "summary": "Update Custom LLM",
- "description": "Update a custom LLM configuration for the current organization.",
- "operationId": "update_custom_llm_v1_custom_llms__custom_llm_id__put",
+ "summary": "Update agent folder",
+ "description": "Update a workflow's folder assignment for the latest version",
+ "operationId": "update_workflow_folder_v1_workflows__workflow_permanent_id__folder_put",
"parameters": [
{
- "name": "custom_llm_id",
+ "name": "workflow_permanent_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The custom LLM id.",
- "title": "Custom Llm Id"
+ "description": "Workflow permanent ID",
+ "examples": [
+ "wpid_123"
+ ],
+ "title": "Workflow Permanent Id"
},
- "description": "The custom LLM id."
+ "description": "Workflow permanent ID"
},
{
"name": "x-api-key",
@@ -4721,22 +4505,28 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CustomLLMUpdateRequest"
+ "$ref": "#/components/schemas/UpdateWorkflowFolderRequest"
}
}
}
},
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully updated workflow folder",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CustomLLMResponse"
+ "$ref": "#/components/schemas/Workflow"
}
}
}
},
+ "404": {
+ "description": "Workflow not found"
+ },
+ "400": {
+ "description": "Folder not found"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -4748,26 +4538,84 @@
}
}
},
- "x-fern-sdk-method-name": "update_custom_llm"
+ "x-fern-sdk-method-name": "update_workflow_folder"
+ }
+ },
+ "/v1/agents/{workflow_permanent_id}/tags": {
+ "post": {
+ "tags": [
+ "Tags"
+ ],
+ "summary": "Apply agent tags",
+ "description": "Atomically apply tag changes to a workflow. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.",
+ "operationId": "apply_workflow_tags_v1_workflows__workflow_permanent_id__tags_post",
+ "parameters": [
+ {
+ "name": "workflow_permanent_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "description": "Workflow permanent ID",
+ "examples": [
+ "wpid_123"
+ ],
+ "title": "Workflow Permanent Id"
+ },
+ "description": "Workflow permanent ID"
+ }
+ ],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TagApplyRequest"
+ }
+ }
+ }
+ },
+ "responses": {
+ "200": {
+ "description": "Successfully applied tag changes",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/TagsResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Workflow not found"
+ },
+ "422": {
+ "description": "Invalid tag key or value"
+ }
+ },
+ "x-fern-sdk-method-name": "apply_workflow_tags"
},
- "delete": {
+ "get": {
"tags": [
- "Custom LLMs"
+ "Tags"
],
- "summary": "Delete Custom LLM",
- "description": "Delete a custom LLM configuration for the current organization.",
- "operationId": "delete_custom_llm_v1_custom_llms__custom_llm_id__delete",
+ "summary": "Get agent tags",
+ "description": "Get the current tag state for a workflow.",
+ "operationId": "get_workflow_tags_v1_workflows__workflow_permanent_id__tags_get",
"parameters": [
{
- "name": "custom_llm_id",
+ "name": "workflow_permanent_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The custom LLM id.",
- "title": "Custom Llm Id"
+ "description": "Workflow permanent ID",
+ "examples": [
+ "wpid_123"
+ ],
+ "title": "Workflow Permanent Id"
},
- "description": "The custom LLM id."
+ "description": "Workflow permanent ID"
},
{
"name": "x-api-key",
@@ -4790,15 +4638,18 @@
],
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully retrieved tags",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ClearOrganizationAuthTokenResponse"
+ "$ref": "#/components/schemas/TagsResponse"
}
}
}
},
+ "404": {
+ "description": "Workflow not found"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -4810,74 +4661,61 @@
}
}
},
- "x-fern-sdk-method-name": "delete_custom_llm"
+ "x-fern-sdk-method-name": "get_workflow_tags"
}
},
- "/v1/run/tasks/login": {
- "post": {
+ "/v1/agents/{workflow_permanent_id}/tags/{key}": {
+ "delete": {
"tags": [
- "Agents"
+ "Tags"
],
- "summary": "Login Task",
- "description": "Log in to a website using either credential stored in Skyvern, Bitwarden, 1Password, or Azure Vault",
- "operationId": "login_v1_run_tasks_login_post",
+ "summary": "Delete agent tag",
+ "description": "Soft-delete a single tag from a workflow. Writes a DELETE event row.",
+ "operationId": "delete_workflow_tag_v1_workflows__workflow_permanent_id__tags__key__delete",
"parameters": [
{
- "name": "x-api-key",
- "in": "header",
- "required": false,
+ "name": "workflow_permanent_id",
+ "in": "path",
+ "required": true,
"schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
+ "type": "string",
+ "description": "Workflow permanent ID",
+ "examples": [
+ "wpid_123"
+ ],
+ "title": "Workflow Permanent Id"
},
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
+ "description": "Workflow permanent ID"
},
{
- "name": "x-user-agent",
- "in": "header",
- "required": false,
+ "name": "key",
+ "in": "path",
+ "required": true,
"schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
+ "type": "string",
+ "description": "Tag key to delete",
+ "examples": [
+ "env"
],
- "title": "X-User-Agent"
- }
+ "title": "Key"
+ },
+ "description": "Tag key to delete"
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/LoginRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully deleted tag (or no-op if absent)",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/WorkflowRunResponse"
+ "$ref": "#/components/schemas/TagsResponse"
}
}
}
},
+ "404": {
+ "description": "Workflow not found"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -4889,53 +4727,68 @@
}
}
},
- "x-hidden": true,
- "x-excluded": true,
- "x-fern-sdk-method-name": "login",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "# Login with password saved in Skyvern\nfrom skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"skyvern\",\n credential_id=\"cred_123\"),\n)\n"
- },
- {
- "sdk": "python",
- "code": "# Login with password saved in Bitwarden\nfrom skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\n# Login with a Bitwarden collection and website url filter\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"bitwarden\",\n bitwarden_collection_id=\"BITWARDEN COLLECTION ID\",\n)\n\n# Login with a Bitwarden item\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"bitwarden\",\n bitwarden_item_id=\"BITWARDEN ITEM ID\",\n)\n"
- },
- {
- "sdk": "python",
- "code": "# Login with password saved in 1Password\nfrom skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.login(\n url=\"https://example.com\",\n credential_type=\"onepassword\",\n onepassword_vault_id=\"1PASSWORD VAULT ID\",\n onepassword_item_id=\"1PASSWORD ITEM ID\",\n)\n"
- },
- {
- "sdk": "typescript",
- "code": "// Login with password saved in Skyvern\nimport { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"skyvern\",\n credential_id: \"cred_123\"\n});\n"
- },
- {
- "sdk": "typescript",
- "code": "// Login with password saved in Bitwarden\nimport { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\n// Login with a Bitwarden collection and website url filter\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"bitwarden\",\n bitwarden_collection_id: \"BITWARDEN COLLECTION ID\"\n});\n\n// Login with a Bitwarden item\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"bitwarden\",\n bitwarden_item_id: \"BITWARDEN ITEM ID\"\n});\n"
- },
- {
- "sdk": "typescript",
- "code": "// Login with password saved in 1Password\nimport { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.login({\n url: \"https://example.com\",\n credential_type: \"onepassword\",\n onepassword_vault_id: \"1PASSWORD VAULT ID\",\n onepassword_item_id: \"1PASSWORD ITEM ID\"\n});\n"
- }
- ]
- }
- ]
+ "x-fern-sdk-method-name": "delete_workflow_tag"
}
},
- "/v1/run/tasks/download_files": {
- "post": {
+ "/v1/agents/{workflow_permanent_id}/tags/history": {
+ "get": {
"tags": [
- "Agents"
+ "Tags"
],
- "summary": "File Download Task",
- "description": "Download a file from a website by navigating and clicking download buttons",
- "operationId": "download_files_v1_run_tasks_download_files_post",
+ "summary": "Get agent tag history",
+ "description": "Chronological tag-event log for a workflow (newest first). Includes SET and DELETE events.",
+ "operationId": "get_workflow_tag_history_v1_workflows__workflow_permanent_id__tags_history_get",
"parameters": [
{
- "name": "x-api-key",
- "in": "header",
+ "name": "workflow_permanent_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "description": "Workflow permanent ID",
+ "examples": [
+ "wpid_123"
+ ],
+ "title": "Workflow Permanent Id"
+ },
+ "description": "Workflow permanent ID"
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "maximum": 500,
+ "minimum": 1,
+ "description": "Max events to return",
+ "default": 100,
+ "title": "Limit"
+ },
+ "description": "Max events to return"
+ },
+ {
+ "name": "since",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string",
+ "format": "date-time"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only return events at or after this timestamp",
+ "title": "Since"
+ },
+ "description": "Only return events at or after this timestamp"
+ },
+ {
+ "name": "key",
+ "in": "query",
"required": false,
"schema": {
"anyOf": [
@@ -4946,13 +4799,13 @@
"type": "null"
}
],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
+ "description": "Filter to events for a single tag key",
+ "title": "Key"
},
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
+ "description": "Filter to events for a single tag key"
},
{
- "name": "x-user-agent",
+ "name": "x-api-key",
"in": "header",
"required": false,
"schema": {
@@ -4964,31 +4817,26 @@
"type": "null"
}
],
- "title": "X-User-Agent"
- }
+ "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
+ "title": "X-Api-Key"
+ },
+ "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/DownloadFilesRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successful Response",
+ "description": "Successfully retrieved tag history",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/WorkflowRunResponse"
+ "$ref": "#/components/schemas/TagHistoryResponse"
}
}
}
},
+ "404": {
+ "description": "Workflow not found"
+ },
"422": {
"description": "Validation Error",
"content": {
@@ -5000,34 +4848,32 @@
}
}
},
- "x-hidden": true,
- "x-excluded": true,
- "x-fern-sdk-method-name": "download_files",
- "x-fern-examples": [
- {
- "code-samples": [
- {
- "sdk": "python",
- "code": "from skyvern import Skyvern\n\nskyvern = Skyvern(api_key=\"YOUR_API_KEY\")\nawait skyvern.download_files(\n url=\"https://example.com/downloads\",\n navigation_goal=\"Navigate to the downloads page and click the 'Download PDF' button\",\n download_suffix=\"report.pdf\"\n)\n"
- },
- {
- "sdk": "typescript",
- "code": "import { SkyvernClient } from \"@skyvern/client\";\n\nconst skyvern = new SkyvernClient({ apiKey: \"YOUR_API_KEY\" });\nawait skyvern.downloadFiles({\n url: \"https://example.com/downloads\",\n navigation_goal: \"Navigate to the downloads page and click the 'Download PDF' button\",\n download_suffix: \"report.pdf\"\n});\n"
- }
- ]
- }
- ]
+ "x-fern-sdk-method-name": "get_workflow_tag_history"
}
},
- "/v1/scripts": {
+ "/v1/agents/runs/{workflow_run_id}/retry": {
"post": {
"tags": [
- "Scripts"
+ "Runs"
],
- "summary": "Create script",
- "description": "Create a new script with optional files and metadata",
- "operationId": "create_script_v1_scripts_post",
+ "summary": "Retry a run",
+ "description": "Retry a workflow run using the original run parameters.",
+ "operationId": "retry_workflow_run_v1_workflows_runs__workflow_run_id__retry_post",
"parameters": [
+ {
+ "name": "workflow_run_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "description": "The id of the workflow run to retry.",
+ "examples": [
+ "wr_123"
+ ],
+ "title": "Workflow Run Id"
+ },
+ "description": "The id of the workflow run to retry."
+ },
{
"name": "x-api-key",
"in": "header",
@@ -5045,32 +4891,60 @@
"title": "X-Api-Key"
},
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/CreateScriptRequest"
- }
- }
- }
- },
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/CreateScriptResponse"
+ },
+ {
+ "name": "x-max-steps-override",
+ "in": "header",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "null"
}
- }
+ ],
+ "title": "X-Max-Steps-Override"
}
},
- "422": {
- "description": "Validation Error",
- "content": {
+ {
+ "name": "x-user-agent",
+ "in": "header",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "X-User-Agent"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Successfully retried workflow run",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/WorkflowRunResponse"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "Workflow run is not retryable"
+ },
+ "404": {
+ "description": "Workflow run not found"
+ },
+ "422": {
+ "description": "Validation Error",
+ "content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
@@ -5079,15 +4953,17 @@
}
}
},
- "x-fern-sdk-method-name": "create_script"
- },
+ "x-fern-sdk-method-name": "retry_workflow_run"
+ }
+ },
+ "/v1/agents/runs": {
"get": {
"tags": [
- "Scripts"
+ "Runs"
],
- "summary": "Get all scripts",
- "description": "Retrieves a paginated list of scripts for the current organization",
- "operationId": "get_scripts_v1_scripts_get",
+ "summary": "Get all runs",
+ "description": "List workflow runs across all workflows for the current organization.\n\nResults are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned.\n\n### search_key\n\nA case-insensitive substring search that matches against **any** of the following fields:\n\n| Searched field | Description |\n|---|---|\n| `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) |\n| Parameter **key** | The `key` of any workflow parameter definition associated with the run |\n| Parameter **description** | The `description` of any workflow parameter definition |\n| Run parameter **value** | The actual value supplied for any parameter when the run was created |\n| `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) |\n\nSoft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term.\n\n### error_code\n\nAn **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`).\n\n### Combining filters\n\nAll query parameters use AND logic:\n- `?status=failed` — only failed runs\n- `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error\n- `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match",
+ "operationId": "get_workflow_runs_v1_workflows_runs_get",
"parameters": [
{
"name": "page",
@@ -5096,14 +4972,11 @@
"schema": {
"type": "integer",
"minimum": 1,
- "description": "Page number for pagination",
- "examples": [
- 1
- ],
+ "description": "Page number for pagination.",
"default": 1,
"title": "Page"
},
- "description": "Page number for pagination"
+ "description": "Page number for pagination."
},
{
"name": "page_size",
@@ -5112,14 +4985,80 @@
"schema": {
"type": "integer",
"minimum": 1,
- "description": "Number of items per page",
- "examples": [
- 10
- ],
+ "description": "Number of runs to return per page.",
"default": 10,
"title": "Page Size"
},
- "description": "Number of items per page"
+ "description": "Number of runs to return per page."
+ },
+ {
+ "name": "status",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/WorkflowRunStatus"
+ }
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Filter by one or more run statuses.",
+ "title": "Status"
+ },
+ "description": "Filter by one or more run statuses."
+ },
+ {
+ "name": "search_key",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string",
+ "maxLength": 500
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.",
+ "examples": [
+ "login_url",
+ "credential_value",
+ "wr_abc123"
+ ],
+ "title": "Search Key"
+ },
+ "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching."
+ },
+ {
+ "name": "error_code",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string",
+ "maxLength": 500
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.",
+ "examples": [
+ "INVALID_CREDENTIALS",
+ "LOGIN_FAILED",
+ "CAPTCHA_DETECTED"
+ ],
+ "title": "Error Code"
+ },
+ "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution."
},
{
"name": "x-api-key",
@@ -5148,9 +5087,9 @@
"schema": {
"type": "array",
"items": {
- "$ref": "#/components/schemas/Script"
+ "$ref": "#/components/schemas/WorkflowRun"
},
- "title": "Response Get Scripts V1 Scripts Get"
+ "title": "Response Get Workflow Runs V1 Workflows Runs Get"
}
}
}
@@ -5166,31 +5105,121 @@
}
}
},
- "x-fern-sdk-method-name": "get_scripts"
+ "x-fern-sdk-method-name": "get_workflow_runs"
}
},
- "/v1/scripts/{script_id}": {
+ "/v1/agents/{workflow_id}/runs": {
"get": {
"tags": [
- "Scripts"
+ "Runs"
],
- "summary": "Get script by ID",
- "description": "Retrieves a specific script by its ID",
- "operationId": "get_script_v1_scripts__script_id__get",
+ "summary": "Get all runs by agent",
+ "description": "List runs for a specific workflow.\n\nSupports filtering by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic.\n\n### search_key\n\nCase-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.\n\n### error_code\n\nExact-match filter on the `error_code` field inside each task's `errors` JSON array. A run matches if any of its tasks contains an error with a matching `error_code`.",
+ "operationId": "get_workflow_runs_by_id_v1_workflows__workflow_id__runs_get",
"parameters": [
{
- "name": "script_id",
+ "name": "workflow_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The unique identifier of the script",
+ "title": "Workflow Id"
+ }
+ },
+ {
+ "name": "page",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "Page number for pagination.",
+ "default": 1,
+ "title": "Page"
+ },
+ "description": "Page number for pagination."
+ },
+ {
+ "name": "page_size",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "Number of runs to return per page.",
+ "default": 10,
+ "title": "Page Size"
+ },
+ "description": "Number of runs to return per page."
+ },
+ {
+ "name": "status",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/WorkflowRunStatus"
+ }
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Filter by one or more run statuses.",
+ "title": "Status"
+ },
+ "description": "Filter by one or more run statuses."
+ },
+ {
+ "name": "search_key",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string",
+ "maxLength": 500
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.",
"examples": [
- "s_abc123"
+ "login_url",
+ "credential_value",
+ "wr_abc123"
],
- "title": "Script Id"
+ "title": "Search Key"
},
- "description": "The unique identifier of the script"
+ "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching."
+ },
+ {
+ "name": "error_code",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "string",
+ "maxLength": 500
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.",
+ "examples": [
+ "INVALID_CREDENTIALS",
+ "LOGIN_FAILED",
+ "CAPTCHA_DETECTED"
+ ],
+ "title": "Error Code"
+ },
+ "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution."
},
{
"name": "x-api-key",
@@ -5217,7 +5246,11 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/Script"
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/WorkflowRun"
+ },
+ "title": "Response Get Workflow Runs By Id V1 Workflows Workflow Id Runs Get"
}
}
}
@@ -5233,31 +5266,51 @@
}
}
},
- "x-fern-sdk-method-name": "get_script"
+ "x-fern-sdk-method-name": "get_workflow_runs_by_id"
}
},
- "/v1/scripts/{script_id}/deploy": {
- "post": {
+ "/v1/agents/{workflow_permanent_id}": {
+ "get": {
"tags": [
- "Scripts"
+ "Agents"
],
- "summary": "Deploy script",
- "description": "Deploy a script with updated files, creating a new version",
- "operationId": "deploy_script_v1_scripts__script_id__deploy_post",
+ "summary": "Get an agent by id",
+ "operationId": "get_workflow_v1_workflows__workflow_permanent_id__get",
"parameters": [
{
- "name": "script_id",
+ "name": "workflow_permanent_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The unique identifier of the script",
- "examples": [
- "s_abc123"
+ "title": "Workflow Permanent Id"
+ }
+ },
+ {
+ "name": "version",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
],
- "title": "Script Id"
- },
- "description": "The unique identifier of the script"
+ "title": "Version"
+ }
+ },
+ {
+ "name": "template",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "boolean",
+ "default": false,
+ "title": "Template"
+ }
},
{
"name": "x-api-key",
@@ -5278,23 +5331,13 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/DeployScriptRequest"
- }
- }
- }
- },
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CreateScriptResponse"
+ "$ref": "#/components/schemas/Workflow"
}
}
}
@@ -5310,31 +5353,36 @@
}
}
},
- "x-fern-sdk-method-name": "deploy_script"
+ "x-fern-sdk-method-name": "get_workflow"
}
},
- "/v1/scripts/{script_id}/run": {
- "post": {
+ "/v1/agents/{workflow_permanent_id}/versions": {
+ "get": {
"tags": [
- "Scripts"
+ "Agents"
],
- "summary": "Run script",
- "description": "Run a script",
- "operationId": "run_script_v1_scripts__script_id__run_post",
+ "summary": "Get agent versions",
+ "description": "Get all versions of a workflow by its permanent ID.",
+ "operationId": "get_workflow_versions_v1_workflows__workflow_permanent_id__versions_get",
"parameters": [
{
- "name": "script_id",
+ "name": "workflow_permanent_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The unique identifier of the script",
- "examples": [
- "s_abc123"
- ],
- "title": "Script Id"
- },
- "description": "The unique identifier of the script"
+ "title": "Workflow Permanent Id"
+ }
+ },
+ {
+ "name": "template",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "type": "boolean",
+ "default": false,
+ "title": "Template"
+ }
},
{
"name": "x-api-key",
@@ -5360,7 +5408,13 @@
"description": "Successful Response",
"content": {
"application/json": {
- "schema": {}
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Workflow"
+ },
+ "title": "Response Get Workflow Versions V1 Workflows Workflow Permanent Id Versions Get"
+ }
}
}
},
@@ -5374,18 +5428,33 @@
}
}
}
- }
+ },
+ "x-fern-sdk-method-name": "get_workflow_versions"
}
},
- "/v1/sdk/run_action": {
+ "/v1/agents/{workflow_permanent_id}/browser_session/reset_profile": {
"post": {
"tags": [
- "SDK"
+ "Agents"
],
- "summary": "Run an SDK action",
- "description": "Execute a single SDK action with the specified parameters",
- "operationId": "run_sdk_action_v1_sdk_run_action_post",
+ "summary": "Reset persisted browser profile",
+ "description": "Clear the persisted browser profile for a workflow that uses `Save & Reuse Session`. The next run will start from a fresh browser state. Use when a saved profile is corrupted.",
+ "operationId": "reset_workflow_browser_profile",
"parameters": [
+ {
+ "name": "workflow_permanent_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "description": "The permanent ID of the workflow. Starts with `wpid_`.",
+ "examples": [
+ "wpid_123"
+ ],
+ "title": "Workflow Permanent Id"
+ },
+ "description": "The permanent ID of the workflow. Starts with `wpid_`."
+ },
{
"name": "x-api-key",
"in": "header",
@@ -5405,26 +5474,15 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/RunSdkActionRequest"
- }
- }
- }
- },
"responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/RunSdkActionResponse"
- }
- }
- }
+ "204": {
+ "description": "Successfully cleared persisted browser profile"
+ },
+ "404": {
+ "description": "Workflow not found"
+ },
+ "500": {
+ "description": "Storage deletion failed; retry"
},
"422": {
"description": "Validation Error",
@@ -5437,81 +5495,26 @@
}
}
},
- "x-excluded": true,
- "x-fern-sdk-method-name": "run_sdk_action"
+ "x-hidden": true
}
},
- "/v1/schedules": {
- "get": {
+ "/v1/agents/{workflow_permanent_id}/schedules": {
+ "post": {
"tags": [
"Schedules"
],
- "summary": "List all schedules for the organization",
- "operationId": "schedules_list_all",
+ "summary": "Create a schedule for an agent",
+ "operationId": "schedules_create",
"parameters": [
{
- "name": "page",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "default": 1,
- "title": "Page"
- }
- },
- {
- "name": "page_size",
- "in": "query",
- "required": false,
+ "name": "workflow_permanent_id",
+ "in": "path",
+ "required": true,
"schema": {
- "type": "integer",
- "maximum": 100,
- "minimum": 1,
- "default": 10,
- "title": "Page Size"
+ "type": "string",
+ "title": "Workflow Permanent Id"
}
},
- {
- "name": "status",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "enum": [
- "active",
- "paused"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Filter by status: 'active' or 'paused'",
- "title": "Status"
- },
- "description": "Filter by status: 'active' or 'paused'"
- },
- {
- "name": "search",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Search by workflow title or schedule name",
- "title": "Search"
- },
- "description": "Search by workflow title or schedule name"
- },
{
"name": "x-api-key",
"in": "header",
@@ -5531,13 +5534,23 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/WorkflowScheduleUpsertRequest"
+ }
+ }
+ }
+ },
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/OrganizationScheduleListResponse"
+ "$ref": "#/components/schemas/WorkflowScheduleResponse"
}
}
}
@@ -5553,30 +5566,22 @@
}
}
}
- }
- },
- "/v1/agents/{workflow_permanent_id}/folder": {
- "put": {
+ },
+ "get": {
"tags": [
- "Folders"
+ "Schedules"
],
- "summary": "Update agent folder",
- "description": "Update a workflow's folder assignment for the latest version",
- "operationId": "update_workflow_folder_v1_workflows__workflow_permanent_id__folder_put",
- "parameters": [
+ "summary": "List schedules for an agent",
+ "operationId": "schedules_list",
+ "parameters": [
{
"name": "workflow_permanent_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "Workflow permanent ID",
- "examples": [
- "wpid_123"
- ],
"title": "Workflow Permanent Id"
- },
- "description": "Workflow permanent ID"
+ }
},
{
"name": "x-api-key",
@@ -5597,33 +5602,17 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/UpdateWorkflowFolderRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully updated workflow folder",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/Workflow"
+ "$ref": "#/components/schemas/WorkflowScheduleListResponse"
}
}
}
},
- "400": {
- "description": "Folder not found"
- },
- "404": {
- "description": "Workflow not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -5634,18 +5623,16 @@
}
}
}
- },
- "x-fern-sdk-method-name": "update_workflow_folder"
+ }
}
},
- "/v1/agents/{workflow_permanent_id}/tags": {
- "post": {
+ "/v1/agents/{workflow_permanent_id}/schedules/{workflow_schedule_id}": {
+ "get": {
"tags": [
- "Tags"
+ "Schedules"
],
- "summary": "Apply agent tags",
- "description": "Atomically apply tag changes to a workflow. Sets and deletes happen in one transaction; same-key collisions resolve set-wins.",
- "operationId": "apply_workflow_tags_v1_workflows__workflow_permanent_id__tags_post",
+ "summary": "Get an agent schedule by id",
+ "operationId": "schedules_get",
"parameters": [
{
"name": "workflow_permanent_id",
@@ -5653,13 +5640,17 @@
"required": true,
"schema": {
"type": "string",
- "description": "Workflow permanent ID",
- "examples": [
- "wpid_123"
- ],
"title": "Workflow Permanent Id"
- },
- "description": "Workflow permanent ID"
+ }
+ },
+ {
+ "name": "workflow_schedule_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "title": "Workflow Schedule Id"
+ }
},
{
"name": "x-api-key",
@@ -5680,43 +5671,35 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/TagApplyRequest"
- }
- }
- }
- },
"responses": {
"200": {
- "description": "Successfully applied tag changes",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagsResponse"
+ "$ref": "#/components/schemas/WorkflowScheduleResponse"
}
}
}
},
- "404": {
- "description": "Workflow not found"
- },
"422": {
- "description": "Invalid tag key or value"
+ "description": "Validation Error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/HTTPValidationError"
+ }
+ }
+ }
}
- },
- "x-fern-sdk-method-name": "apply_workflow_tags"
+ }
},
- "get": {
+ "put": {
"tags": [
- "Tags"
+ "Schedules"
],
- "summary": "Get agent tags",
- "description": "Get the current tag state for a workflow.",
- "operationId": "get_workflow_tags_v1_workflows__workflow_permanent_id__tags_get",
+ "summary": "Update an agent schedule",
+ "operationId": "schedules_update",
"parameters": [
{
"name": "workflow_permanent_id",
@@ -5724,13 +5707,17 @@
"required": true,
"schema": {
"type": "string",
- "description": "Workflow permanent ID",
- "examples": [
- "wpid_123"
- ],
"title": "Workflow Permanent Id"
- },
- "description": "Workflow permanent ID"
+ }
+ },
+ {
+ "name": "workflow_schedule_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "title": "Workflow Schedule Id"
+ }
},
{
"name": "x-api-key",
@@ -5751,20 +5738,27 @@
"description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
}
],
+ "requestBody": {
+ "required": true,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/WorkflowScheduleUpsertRequest"
+ }
+ }
+ }
+ },
"responses": {
"200": {
- "description": "Successfully retrieved tags",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagsResponse"
+ "$ref": "#/components/schemas/WorkflowScheduleResponse"
}
}
}
},
- "404": {
- "description": "Workflow not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -5775,18 +5769,14 @@
}
}
}
- },
- "x-fern-sdk-method-name": "get_workflow_tags"
- }
- },
- "/v1/agents/{workflow_permanent_id}/tags/{key}": {
+ }
+ },
"delete": {
"tags": [
- "Tags"
+ "Schedules"
],
- "summary": "Delete agent tag",
- "description": "Soft-delete a single tag from a workflow. Writes a DELETE event row.",
- "operationId": "delete_workflow_tag_v1_workflows__workflow_permanent_id__tags__key__delete",
+ "summary": "Delete an agent schedule",
+ "operationId": "schedules_delete",
"parameters": [
{
"name": "workflow_permanent_id",
@@ -5794,27 +5784,17 @@
"required": true,
"schema": {
"type": "string",
- "description": "Workflow permanent ID",
- "examples": [
- "wpid_123"
- ],
"title": "Workflow Permanent Id"
- },
- "description": "Workflow permanent ID"
+ }
},
{
- "name": "key",
+ "name": "workflow_schedule_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "Tag key to delete",
- "examples": [
- "env"
- ],
- "title": "Key"
- },
- "description": "Tag key to delete"
+ "title": "Workflow Schedule Id"
+ }
},
{
"name": "x-api-key",
@@ -5837,18 +5817,15 @@
],
"responses": {
"200": {
- "description": "Successfully deleted tag (or no-op if absent)",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagsResponse"
+ "$ref": "#/components/schemas/DeleteScheduleResponse"
}
}
}
},
- "404": {
- "description": "Workflow not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -5859,18 +5836,16 @@
}
}
}
- },
- "x-fern-sdk-method-name": "delete_workflow_tag"
+ }
}
},
- "/v1/agents/{workflow_permanent_id}/tags/history": {
- "get": {
+ "/v1/agents/{workflow_permanent_id}/schedules/{workflow_schedule_id}/enable": {
+ "post": {
"tags": [
- "Tags"
+ "Schedules"
],
- "summary": "Get agent tag history",
- "description": "Chronological tag-event log for a workflow (newest first). Includes SET and DELETE events.",
- "operationId": "get_workflow_tag_history_v1_workflows__workflow_permanent_id__tags_history_get",
+ "summary": "Enable an agent schedule",
+ "operationId": "schedules_enable",
"parameters": [
{
"name": "workflow_permanent_id",
@@ -5878,64 +5853,17 @@
"required": true,
"schema": {
"type": "string",
- "description": "Workflow permanent ID",
- "examples": [
- "wpid_123"
- ],
"title": "Workflow Permanent Id"
- },
- "description": "Workflow permanent ID"
- },
- {
- "name": "limit",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "maximum": 500,
- "minimum": 1,
- "description": "Max events to return",
- "default": 100,
- "title": "Limit"
- },
- "description": "Max events to return"
- },
- {
- "name": "since",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "description": "Only return events at or after this timestamp",
- "title": "Since"
- },
- "description": "Only return events at or after this timestamp"
+ }
},
{
- "name": "key",
- "in": "query",
- "required": false,
+ "name": "workflow_schedule_id",
+ "in": "path",
+ "required": true,
"schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Filter to events for a single tag key",
- "title": "Key"
- },
- "description": "Filter to events for a single tag key"
+ "type": "string",
+ "title": "Workflow Schedule Id"
+ }
},
{
"name": "x-api-key",
@@ -5958,18 +5886,15 @@
],
"responses": {
"200": {
- "description": "Successfully retrieved tag history",
+ "description": "Successful Response",
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/TagHistoryResponse"
+ "$ref": "#/components/schemas/WorkflowScheduleResponse"
}
}
}
},
- "404": {
- "description": "Workflow not found"
- },
"422": {
"description": "Validation Error",
"content": {
@@ -5980,216 +5905,34 @@
}
}
}
- },
- "x-fern-sdk-method-name": "get_workflow_tag_history"
+ }
}
},
- "/v1/agents/runs/{workflow_run_id}/retry": {
+ "/v1/agents/{workflow_permanent_id}/schedules/{workflow_schedule_id}/disable": {
"post": {
"tags": [
- "Runs"
+ "Schedules"
],
- "summary": "Retry a run",
- "description": "Retry a workflow run using the original run parameters.",
- "operationId": "retry_workflow_run_v1_workflows_runs__workflow_run_id__retry_post",
+ "summary": "Disable an agent schedule",
+ "operationId": "schedules_disable",
"parameters": [
{
- "name": "workflow_run_id",
+ "name": "workflow_permanent_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
- "description": "The id of the workflow run to retry.",
- "examples": [
- "wr_123"
- ],
- "title": "Workflow Run Id"
- },
- "description": "The id of the workflow run to retry."
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "X-Api-Key"
- }
- },
- {
- "name": "x-max-steps-override",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "X-Max-Steps-Override"
+ "title": "Workflow Permanent Id"
}
},
{
- "name": "x-user-agent",
- "in": "header",
- "required": false,
+ "name": "workflow_schedule_id",
+ "in": "path",
+ "required": true,
"schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "X-User-Agent"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "Successfully retried workflow run",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowRunResponse"
- }
- }
- }
- },
- "400": {
- "description": "Workflow run is not retryable"
- },
- "404": {
- "description": "Workflow run not found"
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
+ "type": "string",
+ "title": "Workflow Schedule Id"
}
- }
- },
- "x-fern-sdk-method-name": "retry_workflow_run"
- }
- },
- "/v1/agents/runs": {
- "get": {
- "tags": [
- "Runs"
- ],
- "summary": "Get all runs",
- "description": "List workflow runs across all workflows for the current organization.\n\nResults are paginated and can be filtered by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic — a run must match every supplied filter to be returned.\n\n### search_key\n\nA case-insensitive substring search that matches against **any** of the following fields:\n\n| Searched field | Description |\n|---|---|\n| `workflow_run_id` | The unique run identifier (e.g. `wr_123…`) |\n| Parameter **key** | The `key` of any workflow parameter definition associated with the run |\n| Parameter **description** | The `description` of any workflow parameter definition |\n| Run parameter **value** | The actual value supplied for any parameter when the run was created |\n| `extra_http_headers` | Extra HTTP headers attached to the run (searched as raw JSON text) |\n\nSoft-deleted parameter definitions are excluded from key/description matching. A run is returned if **any** of the fields above contain the search term.\n\n### error_code\n\nAn **exact-match** filter against the `error_code` field inside each task's `errors` JSON array. A run matches if **any** of its tasks contains an error object with a matching `error_code` value. Error codes are user-defined strings set during workflow execution (e.g. `INVALID_CREDENTIALS`, `LOGIN_FAILED`, `CAPTCHA_DETECTED`).\n\n### Combining filters\n\nAll query parameters use AND logic:\n- `?status=failed` — only failed runs\n- `?status=failed&error_code=LOGIN_FAILED` — failed runs **and** have a LOGIN_FAILED error\n- `?status=failed&error_code=LOGIN_FAILED&search_key=prod_credential` — all three conditions must match",
- "operationId": "get_workflow_runs_v1_workflows_runs_get",
- "parameters": [
- {
- "name": "page",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "description": "Page number for pagination.",
- "default": 1,
- "title": "Page"
- },
- "description": "Page number for pagination."
- },
- {
- "name": "page_size",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "description": "Number of runs to return per page.",
- "default": 10,
- "title": "Page Size"
- },
- "description": "Number of runs to return per page."
- },
- {
- "name": "status",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/WorkflowRunStatus"
- }
- },
- {
- "type": "null"
- }
- ],
- "description": "Filter by one or more run statuses.",
- "title": "Status"
- },
- "description": "Filter by one or more run statuses."
- },
- {
- "name": "search_key",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "maxLength": 500
- },
- {
- "type": "null"
- }
- ],
- "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.",
- "examples": [
- "login_url",
- "credential_value",
- "wr_abc123"
- ],
- "title": "Search Key"
- },
- "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching."
- },
- {
- "name": "error_code",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "maxLength": 500
- },
- {
- "type": "null"
- }
- ],
- "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.",
- "examples": [
- "INVALID_CREDENTIALS",
- "LOGIN_FAILED",
- "CAPTCHA_DETECTED"
- ],
- "title": "Error Code"
- },
- "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution."
},
{
"name": "x-api-key",
@@ -6216,11 +5959,7 @@
"content": {
"application/json": {
"schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/WorkflowRun"
- },
- "title": "Response Get Workflow Runs V1 Workflows Runs Get"
+ "$ref": "#/components/schemas/WorkflowScheduleResponse"
}
}
}
@@ -6235,1406 +5974,34 @@
}
}
}
- },
- "x-fern-sdk-method-name": "get_workflow_runs"
+ }
}
- },
- "/v1/agents/{workflow_id}/runs": {
- "get": {
- "tags": [
- "Runs"
+ }
+ },
+ "components": {
+ "schemas": {
+ "AIFallbackMode": {
+ "type": "string",
+ "enum": [
+ "fallback",
+ "proactive"
],
- "summary": "Get all runs by agent",
- "description": "List runs for a specific workflow.\n\nSupports filtering by **status**, **search_key**, and **error_code**. All filters are combined with **AND** logic.\n\n### search_key\n\nCase-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.\n\n### error_code\n\nExact-match filter on the `error_code` field inside each task's `errors` JSON array. A run matches if any of its tasks contains an error with a matching `error_code`.",
- "operationId": "get_workflow_runs_by_id_v1_workflows__workflow_id__runs_get",
- "parameters": [
- {
- "name": "workflow_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Id"
- }
+ "title": "AIFallbackMode",
+ "description": "Controls how an action block uses a CSS/XPath selector relative to AI.\n\n- `fallback`: attempt the selector first; fall back to AI on failure.\n- `proactive`: always use AI; the selector (if any) is a hint only.\n\nWhen `selector` is None, both modes degrade to AI-only — the difference\nis purely semantic (whether the author expected to have a selector here)."
+ },
+ "AWSSecretParameter": {
+ "properties": {
+ "parameter_type": {
+ "type": "string",
+ "const": "aws_secret",
+ "title": "Parameter Type",
+ "default": "aws_secret"
},
- {
- "name": "page",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "description": "Page number for pagination.",
- "default": 1,
- "title": "Page"
- },
- "description": "Page number for pagination."
- },
- {
- "name": "page_size",
- "in": "query",
- "required": false,
- "schema": {
- "type": "integer",
- "minimum": 1,
- "description": "Number of runs to return per page.",
- "default": 10,
- "title": "Page Size"
- },
- "description": "Number of runs to return per page."
- },
- {
- "name": "status",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/WorkflowRunStatus"
- }
- },
- {
- "type": "null"
- }
- ],
- "description": "Filter by one or more run statuses.",
- "title": "Status"
- },
- "description": "Filter by one or more run statuses."
- },
- {
- "name": "search_key",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "maxLength": 500
- },
- {
- "type": "null"
- }
- ],
- "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.",
- "examples": [
- "login_url",
- "credential_value",
- "wr_abc123"
- ],
- "title": "Search Key"
- },
- "description": "Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching."
- },
- {
- "name": "error_code",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "maxLength": 500
- },
- {
- "type": "null"
- }
- ],
- "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.",
- "examples": [
- "INVALID_CREDENTIALS",
- "LOGIN_FAILED",
- "CAPTCHA_DETECTED"
- ],
- "title": "Error Code"
- },
- "description": "Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution."
- },
- {
- "name": "created_at_start",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "description": "Only include runs created at or after this UTC timestamp (ISO 8601).",
- "title": "Created At Start"
- },
- "description": "Only include runs created at or after this UTC timestamp (ISO 8601)."
- },
- {
- "name": "created_at_end",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "description": "Only include runs created strictly before this UTC timestamp (ISO 8601).",
- "title": "Created At End"
- },
- "description": "Only include runs created strictly before this UTC timestamp (ISO 8601)."
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/WorkflowRun"
- },
- "title": "Response Get Workflow Runs By Id V1 Workflows Workflow Id Runs Get"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- },
- "x-fern-sdk-method-name": "get_workflow_runs_by_id"
- }
- },
- "/v1/agents/{workflow_permanent_id}": {
- "get": {
- "tags": [
- "Agents"
- ],
- "summary": "Get an agent by id",
- "operationId": "get_workflow_v1_workflows__workflow_permanent_id__get",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "version",
- "in": "query",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Version"
- }
- },
- {
- "name": "template",
- "in": "query",
- "required": false,
- "schema": {
- "type": "boolean",
- "default": false,
- "title": "Template"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Workflow"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- },
- "x-fern-sdk-method-name": "get_workflow"
- }
- },
- "/v1/agents/{workflow_permanent_id}/versions": {
- "get": {
- "tags": [
- "Agents"
- ],
- "summary": "Get agent versions",
- "description": "Get all versions of a workflow by its permanent ID.",
- "operationId": "get_workflow_versions_v1_workflows__workflow_permanent_id__versions_get",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "template",
- "in": "query",
- "required": false,
- "schema": {
- "type": "boolean",
- "default": false,
- "title": "Template"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Workflow"
- },
- "title": "Response Get Workflow Versions V1 Workflows Workflow Permanent Id Versions Get"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- },
- "x-fern-sdk-method-name": "get_workflow_versions"
- }
- },
- "/v1/agents/{workflow_permanent_id}/browser_session/reset_profile": {
- "post": {
- "tags": [
- "Agents"
- ],
- "summary": "Reset persisted browser profile",
- "description": "Clear the persisted browser profile for a workflow that uses `Save & Reuse Session`. The next run will start from a fresh browser state. Use when a saved profile is corrupted.",
- "operationId": "reset_workflow_browser_profile",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "description": "The permanent ID of the workflow. Starts with `wpid_`.",
- "examples": [
- "wpid_123"
- ],
- "title": "Workflow Permanent Id"
- },
- "description": "The permanent ID of the workflow. Starts with `wpid_`."
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "204": {
- "description": "Successfully cleared persisted browser profile"
- },
- "404": {
- "description": "Workflow not found"
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- },
- "500": {
- "description": "Storage deletion failed; retry"
- }
- },
- "x-hidden": true
- }
- },
- "/v1/agents/{workflow_permanent_id}/schedules": {
- "post": {
- "tags": [
- "Schedules"
- ],
- "summary": "Create a schedule for an agent",
- "operationId": "schedules_create",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleUpsertRequest"
- }
- }
- }
- },
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- },
- "get": {
- "tags": [
- "Schedules"
- ],
- "summary": "List schedules for an agent",
- "operationId": "schedules_list",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleListResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- }
- },
- "/v1/agents/{workflow_permanent_id}/schedules/{workflow_schedule_id}": {
- "get": {
- "tags": [
- "Schedules"
- ],
- "summary": "Get an agent schedule by id",
- "operationId": "schedules_get",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "workflow_schedule_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Schedule Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- },
- "put": {
- "tags": [
- "Schedules"
- ],
- "summary": "Update an agent schedule",
- "operationId": "schedules_update",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "workflow_schedule_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Schedule Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "requestBody": {
- "required": true,
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleUpsertRequest"
- }
- }
- }
- },
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- },
- "delete": {
- "tags": [
- "Schedules"
- ],
- "summary": "Delete an agent schedule",
- "operationId": "schedules_delete",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "workflow_schedule_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Schedule Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/DeleteScheduleResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- }
- },
- "/v1/agents/{workflow_permanent_id}/schedules/{workflow_schedule_id}/enable": {
- "post": {
- "tags": [
- "Schedules"
- ],
- "summary": "Enable an agent schedule",
- "operationId": "schedules_enable",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "workflow_schedule_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Schedule Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- }
- },
- "/v1/agents/{workflow_permanent_id}/schedules/{workflow_schedule_id}/disable": {
- "post": {
- "tags": [
- "Schedules"
- ],
- "summary": "Disable an agent schedule",
- "operationId": "schedules_disable",
- "parameters": [
- {
- "name": "workflow_permanent_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Permanent Id"
- }
- },
- {
- "name": "workflow_schedule_id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "string",
- "title": "Workflow Schedule Id"
- }
- },
- {
- "name": "x-api-key",
- "in": "header",
- "required": false,
- "schema": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.",
- "title": "X-Api-Key"
- },
- "description": "Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings."
- }
- ],
- "responses": {
- "200": {
- "description": "Successful Response",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/WorkflowScheduleResponse"
- }
- }
- }
- },
- "422": {
- "description": "Validation Error",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/HTTPValidationError"
- }
- }
- }
- }
- }
- }
- }
- },
- "components": {
- "schemas": {
- "AIFallbackMode": {
- "type": "string",
- "enum": [
- "fallback",
- "proactive"
- ],
- "title": "AIFallbackMode",
- "description": "Controls how an action block uses a CSS/XPath selector relative to AI.\n\n- `fallback`: attempt the selector first; fall back to AI on failure.\n- `proactive`: always use AI; the selector (if any) is a hint only.\n\nWhen `selector` is None, both modes degrade to AI-only — the difference\nis purely semantic (whether the author expected to have a selector here)."
- },
- "AWSSecretParameter": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "aws_secret",
- "title": "Parameter Type",
- "default": "aws_secret"
- },
- "key": {
- "type": "string",
- "title": "Key"
- },
- "description": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Description"
- },
- "aws_secret_parameter_id": {
- "type": "string",
- "title": "Aws Secret Parameter Id"
- },
- "workflow_id": {
- "type": "string",
- "title": "Workflow Id"
- },
- "aws_key": {
- "type": "string",
- "title": "Aws Key"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
- },
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
- },
- "deleted_at": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "title": "Deleted At"
- }
- },
- "type": "object",
- "required": [
- "key",
- "aws_secret_parameter_id",
- "workflow_id",
- "aws_key",
- "created_at",
- "modified_at"
- ],
- "title": "AWSSecretParameter"
- },
- "AWSSecretParameterYAML": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "aws_secret",
- "title": "Parameter Type",
- "default": "aws_secret"
- },
- "key": {
- "type": "string",
- "title": "Key"
- },
- "description": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Description"
- },
- "aws_key": {
- "type": "string",
- "title": "Aws Key"
- }
- },
- "type": "object",
- "required": [
- "key",
- "aws_key"
- ],
- "title": "AWSSecretParameterYAML"
- },
- "ActAction": {
- "properties": {
- "type": {
- "type": "string",
- "const": "ai_act",
- "title": "Type",
- "default": "ai_act"
- },
- "intention": {
- "type": "string",
- "title": "Intention",
- "description": "Natural language prompt for the action",
- "default": ""
- },
- "data": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Data",
- "description": "Additional context data"
- }
- },
- "type": "object",
- "title": "ActAction",
- "description": "AI act action parameters."
- },
- "Action": {
- "properties": {
- "action_type": {
- "$ref": "#/components/schemas/ActionType"
- },
- "status": {
- "$ref": "#/components/schemas/ActionStatus",
- "default": "pending"
- },
- "action_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Action Id"
- },
- "source_action_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Source Action Id"
- },
- "organization_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Organization Id"
- },
- "workflow_run_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Workflow Run Id"
- },
- "task_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Task Id"
- },
- "step_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Step Id"
- },
- "step_order": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Step Order"
- },
- "action_order": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Action Order"
- },
- "confidence_float": {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "null"
- }
- ],
- "title": "Confidence Float"
- },
- "description": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Description"
- },
- "reasoning": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Reasoning"
- },
- "intention": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Intention"
- },
- "response": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Response"
- },
- "element_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Element Id"
- },
- "skyvern_element_hash": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Skyvern Element Hash"
- },
- "skyvern_element_data": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Skyvern Element Data"
- },
- "screenshot_artifact_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Screenshot Artifact Id"
- },
- "tool_call_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Tool Call Id"
- },
- "xpath": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Xpath"
- },
- "errors": {
- "anyOf": [
- {
- "items": {
- "$ref": "#/components/schemas/UserDefinedError"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Errors"
- },
- "terminal_user_errors": {
- "type": "boolean",
- "title": "Terminal User Errors",
- "default": false
- },
- "data_extraction_goal": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Data Extraction Goal"
- },
- "output": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "items": {},
- "type": "array"
- },
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Output"
- },
- "file_name": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "File Name"
- },
- "file_url": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "File Url"
- },
- "download": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "title": "Download"
- },
- "download_triggered": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "title": "Download Triggered"
- },
- "downloaded_files": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Downloaded Files"
- },
- "is_upload_file_tag": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "title": "Is Upload File Tag"
+ "key": {
+ "type": "string",
+ "title": "Key"
},
- "text": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -7643,132 +6010,67 @@
"type": "null"
}
],
- "title": "Text"
- },
- "input_or_select_context": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/InputOrSelectContext"
- },
- {
- "type": "null"
- }
- ]
- },
- "option": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/SelectOption"
- },
- {
- "type": "null"
- }
- ]
- },
- "is_checked": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "title": "Is Checked"
- },
- "verified": {
- "type": "boolean",
- "title": "Verified",
- "default": false
- },
- "click_context": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/ClickContext"
- },
- {
- "type": "null"
- }
- ]
- },
- "totp_timing_info": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Totp Timing Info"
- },
- "has_mini_agent": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "title": "Has Mini Agent"
+ "title": "Description"
},
- "skip_auto_complete_tab": {
- "type": "boolean",
- "title": "Skip Auto Complete Tab",
- "default": false
+ "aws_secret_parameter_id": {
+ "type": "string",
+ "title": "Aws Secret Parameter Id"
},
- "created_at": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
+ },
+ "aws_key": {
+ "type": "string",
+ "title": "Aws Key"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
"title": "Created At"
},
"modified_at": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
+ "type": "string",
+ "format": "date-time",
"title": "Modified At"
},
- "created_by": {
+ "deleted_at": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Created By"
+ "title": "Deleted At"
}
},
"type": "object",
"required": [
- "action_type"
+ "key",
+ "aws_secret_parameter_id",
+ "workflow_id",
+ "aws_key",
+ "created_at",
+ "modified_at"
],
- "title": "Action"
+ "title": "AWSSecretParameter"
},
- "ActionBlock": {
+ "AWSSecretParameterYAML": {
"properties": {
- "label": {
+ "parameter_type": {
"type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
+ "const": "aws_secret",
+ "title": "Parameter Type",
+ "default": "aws_secret"
},
- "next_block_label": {
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
"type": "string"
@@ -7777,25 +6079,39 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
+ "title": "Description"
},
- "block_type": {
+ "aws_key": {
"type": "string",
- "const": "action",
- "title": "Block Type",
- "default": "action"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
+ "title": "Aws Key"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "aws_key"
+ ],
+ "title": "AWSSecretParameterYAML"
+ },
+ "ActAction": {
+ "properties": {
+ "type": {
+ "type": "string",
+ "const": "ai_act",
+ "title": "Type",
+ "default": "ai_act"
},
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "intention": {
+ "type": "string",
+ "title": "Intention",
+ "description": "Natural language prompt for the action",
+ "default": ""
},
- "model": {
+ "data": {
"anyOf": [
+ {
+ "type": "string"
+ },
{
"additionalProperties": true,
"type": "object"
@@ -7804,29 +6120,24 @@
"type": "null"
}
],
- "title": "Model"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
+ "title": "Data",
+ "description": "Additional context data"
+ }
+ },
+ "type": "object",
+ "title": "ActAction",
+ "description": "AI act action parameters."
+ },
+ "Action": {
+ "properties": {
+ "action_type": {
+ "$ref": "#/components/schemas/ActionType"
},
- "task_type": {
- "type": "string",
- "title": "Task Type",
- "default": "general"
+ "status": {
+ "$ref": "#/components/schemas/ActionStatus",
+ "default": "pending"
},
- "url": {
+ "action_id": {
"anyOf": [
{
"type": "string"
@@ -7835,18 +6146,9 @@
"type": "null"
}
],
- "title": "Url"
- },
- "title": {
- "type": "string",
- "title": "Title",
- "default": ""
- },
- "engine": {
- "$ref": "#/components/schemas/RunEngine",
- "default": "skyvern-1.0"
+ "title": "Action Id"
},
- "complete_criterion": {
+ "source_action_id": {
"anyOf": [
{
"type": "string"
@@ -7855,9 +6157,9 @@
"type": "null"
}
],
- "title": "Complete Criterion"
+ "title": "Source Action Id"
},
- "terminate_criterion": {
+ "organization_id": {
"anyOf": [
{
"type": "string"
@@ -7866,9 +6168,9 @@
"type": "null"
}
],
- "title": "Terminate Criterion"
+ "title": "Organization Id"
},
- "navigation_goal": {
+ "workflow_run_id": {
"anyOf": [
{
"type": "string"
@@ -7877,9 +6179,9 @@
"type": "null"
}
],
- "title": "Navigation Goal"
+ "title": "Workflow Run Id"
},
- "data_extraction_goal": {
+ "task_id": {
"anyOf": [
{
"type": "string"
@@ -7888,18 +6190,10 @@
"type": "null"
}
],
- "title": "Data Extraction Goal"
+ "title": "Task Id"
},
- "data_schema": {
+ "step_id": {
"anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "items": {},
- "type": "array"
- },
{
"type": "string"
},
@@ -7907,28 +6201,9 @@
"type": "null"
}
],
- "title": "Data Schema"
- },
- "error_code_mapping": {
- "anyOf": [
- {
- "additionalProperties": {
- "type": "string"
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Error Code Mapping"
- },
- "max_retries": {
- "type": "integer",
- "title": "Max Retries",
- "default": 0
+ "title": "Step Id"
},
- "max_steps_per_run": {
+ "step_order": {
"anyOf": [
{
"type": "integer"
@@ -7937,94 +6212,31 @@
"type": "null"
}
],
- "title": "Max Steps Per Run"
- },
- "parameters": {
- "items": {
- "oneOf": [
- {
- "$ref": "#/components/schemas/WorkflowParameter"
- },
- {
- "$ref": "#/components/schemas/ContextParameter"
- },
- {
- "$ref": "#/components/schemas/AWSSecretParameter"
- },
- {
- "$ref": "#/components/schemas/AzureSecretParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
- },
- {
- "$ref": "#/components/schemas/OnePasswordCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/AzureVaultCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/OutputParameter"
- },
- {
- "$ref": "#/components/schemas/CredentialParameter"
- }
- ],
- "discriminator": {
- "propertyName": "parameter_type",
- "mapping": {
- "aws_secret": "#/components/schemas/AWSSecretParameter",
- "azure_secret": "#/components/schemas/AzureSecretParameter",
- "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
- "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
- "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
- "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
- "context": "#/components/schemas/ContextParameter",
- "credential": "#/components/schemas/CredentialParameter",
- "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
- "output": "#/components/schemas/OutputParameter",
- "workflow": "#/components/schemas/WorkflowParameter"
- }
- }
- },
- "type": "array",
- "title": "Parameters",
- "default": []
- },
- "complete_on_download": {
- "type": "boolean",
- "title": "Complete On Download",
- "default": false
+ "title": "Step Order"
},
- "download_suffix": {
+ "action_order": {
"anyOf": [
{
- "type": "string"
+ "type": "integer"
},
{
"type": "null"
}
],
- "title": "Download Suffix"
+ "title": "Action Order"
},
- "totp_verification_url": {
+ "confidence_float": {
"anyOf": [
{
- "type": "string"
+ "type": "number"
},
{
"type": "null"
}
],
- "title": "Totp Verification Url"
+ "title": "Confidence Float"
},
- "totp_identifier": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -8033,35 +6245,20 @@
"type": "null"
}
],
- "title": "Totp Identifier"
- },
- "complete_verification": {
- "type": "boolean",
- "title": "Complete Verification",
- "default": true
- },
- "include_action_history_in_verification": {
- "type": "boolean",
- "title": "Include Action History In Verification",
- "default": false
+ "title": "Description"
},
- "download_timeout": {
+ "reasoning": {
"anyOf": [
{
- "type": "number"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Download Timeout"
- },
- "include_extracted_text": {
- "type": "boolean",
- "title": "Include Extracted Text",
- "default": true
+ "title": "Reasoning"
},
- "selector": {
+ "intention": {
"anyOf": [
{
"type": "string"
@@ -8070,34 +6267,9 @@
"type": "null"
}
],
- "title": "Selector"
- },
- "ai_fallback": {
- "$ref": "#/components/schemas/AIFallbackMode",
- "default": "fallback"
- }
- },
- "type": "object",
- "required": [
- "label",
- "output_parameter"
- ],
- "title": "ActionBlock"
- },
- "ActionBlockYAML": {
- "properties": {
- "block_type": {
- "type": "string",
- "const": "action",
- "title": "Block Type",
- "default": "action"
- },
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
+ "title": "Intention"
},
- "next_block_label": {
+ "response": {
"anyOf": [
{
"type": "string"
@@ -8106,37 +6278,20 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "title": "Response"
},
- "model": {
+ "element_id": {
"anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Model"
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
+ "title": "Element Id"
},
- "url": {
+ "skyvern_element_hash": {
"anyOf": [
{
"type": "string"
@@ -8145,18 +6300,21 @@
"type": "null"
}
],
- "title": "Url"
- },
- "title": {
- "type": "string",
- "title": "Title",
- "default": ""
+ "title": "Skyvern Element Hash"
},
- "engine": {
- "$ref": "#/components/schemas/RunEngine",
- "default": "skyvern-1.0"
+ "skyvern_element_data": {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Skyvern Element Data"
},
- "navigation_goal": {
+ "screenshot_artifact_id": {
"anyOf": [
{
"type": "string"
@@ -8165,9 +6323,9 @@
"type": "null"
}
],
- "title": "Navigation Goal"
+ "title": "Screenshot Artifact Id"
},
- "selector": {
+ "tool_call_id": {
"anyOf": [
{
"type": "string"
@@ -8176,36 +6334,24 @@
"type": "null"
}
],
- "title": "Selector"
- },
- "ai_fallback": {
- "$ref": "#/components/schemas/AIFallbackMode",
- "default": "fallback"
+ "title": "Tool Call Id"
},
- "error_code_mapping": {
+ "xpath": {
"anyOf": [
{
- "additionalProperties": {
- "type": "string"
- },
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Error Code Mapping"
- },
- "max_retries": {
- "type": "integer",
- "title": "Max Retries",
- "default": 0
+ "title": "Xpath"
},
- "parameter_keys": {
+ "errors": {
"anyOf": [
{
"items": {
- "type": "string"
+ "$ref": "#/components/schemas/UserDefinedError"
},
"type": "array"
},
@@ -8213,14 +6359,14 @@
"type": "null"
}
],
- "title": "Parameter Keys"
+ "title": "Errors"
},
- "complete_on_download": {
+ "terminal_user_errors": {
"type": "boolean",
- "title": "Complete On Download",
+ "title": "Terminal User Errors",
"default": false
},
- "download_suffix": {
+ "data_extraction_goal": {
"anyOf": [
{
"type": "string"
@@ -8229,21 +6375,18 @@
"type": "null"
}
],
- "title": "Download Suffix"
+ "title": "Data Extraction Goal"
},
- "totp_verification_url": {
+ "output": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": true,
+ "type": "object"
},
{
- "type": "null"
- }
- ],
- "title": "Totp Verification Url"
- },
- "totp_identifier": {
- "anyOf": [
+ "items": {},
+ "type": "array"
+ },
{
"type": "string"
},
@@ -8251,93 +6394,9 @@
"type": "null"
}
],
- "title": "Totp Identifier"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- }
- },
- "type": "object",
- "required": [
- "label"
- ],
- "title": "ActionBlockYAML"
- },
- "ActionStatus": {
- "type": "string",
- "enum": [
- "pending",
- "skipped",
- "failed",
- "completed"
- ],
- "title": "ActionStatus"
- },
- "ActionType": {
- "type": "string",
- "enum": [
- "click",
- "input_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"
- ],
- "title": "ActionType"
- },
- "Artifact": {
- "properties": {
- "created_at": {
- "type": "string",
- "title": "Created At",
- "description": "The creation datetime of the task.",
- "examples": [
- "2023-01-01T00:00:00Z"
- ]
- },
- "modified_at": {
- "type": "string",
- "title": "Modified At",
- "description": "The modification datetime of the task.",
- "examples": [
- "2023-01-01T00:00:00Z"
- ]
- },
- "artifact_id": {
- "type": "string",
- "title": "Artifact Id"
- },
- "artifact_type": {
- "$ref": "#/components/schemas/ArtifactType"
- },
- "uri": {
- "type": "string",
- "title": "Uri"
+ "title": "Output"
},
- "bundle_key": {
+ "file_name": {
"anyOf": [
{
"type": "string"
@@ -8346,9 +6405,9 @@
"type": "null"
}
],
- "title": "Bundle Key"
+ "title": "File Name"
},
- "checksum": {
+ "file_url": {
"anyOf": [
{
"type": "string"
@@ -8357,53 +6416,56 @@
"type": "null"
}
],
- "title": "Checksum"
+ "title": "File Url"
},
- "file_size": {
+ "download": {
"anyOf": [
{
- "type": "integer"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "File Size"
+ "title": "Download"
},
- "task_id": {
+ "download_triggered": {
"anyOf": [
{
- "type": "string"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "Task Id"
+ "title": "Download Triggered"
},
- "step_id": {
+ "downloaded_files": {
"anyOf": [
{
- "type": "string"
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
},
{
"type": "null"
}
],
- "title": "Step Id"
+ "title": "Downloaded Files"
},
- "workflow_run_id": {
+ "is_upload_file_tag": {
"anyOf": [
{
- "type": "string"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "Workflow Run Id"
+ "title": "Is Upload File Tag"
},
- "workflow_run_block_id": {
+ "text": {
"anyOf": [
{
"type": "string"
@@ -8412,146 +6474,210 @@
"type": "null"
}
],
- "title": "Workflow Run Block Id"
+ "title": "Text"
},
- "run_id": {
+ "input_or_select_context": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/InputOrSelectContext"
},
{
"type": "null"
}
- ],
- "title": "Run Id"
+ ]
},
- "browser_session_id": {
+ "option": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/SelectOption"
},
{
"type": "null"
}
- ],
- "title": "Browser Session Id"
+ ]
},
- "observer_cruise_id": {
+ "is_checked": {
"anyOf": [
{
- "type": "string"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "Observer Cruise Id"
+ "title": "Is Checked"
},
- "observer_thought_id": {
+ "verified": {
+ "type": "boolean",
+ "title": "Verified",
+ "default": false
+ },
+ "click_context": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/ClickContext"
},
{
"type": "null"
}
- ],
- "title": "Observer Thought Id"
+ ]
},
- "ai_suggestion_id": {
+ "totp_timing_info": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Ai Suggestion Id"
+ "title": "Totp Timing Info"
},
- "signed_url": {
+ "has_mini_agent": {
"anyOf": [
{
- "type": "string"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "Signed Url"
+ "title": "Has Mini Agent"
},
- "archived": {
+ "skip_auto_complete_tab": {
"type": "boolean",
- "title": "Archived",
+ "title": "Skip Auto Complete Tab",
"default": false
},
- "organization_id": {
- "type": "string",
- "title": "Organization Id"
+ "created_at": {
+ "anyOf": [
+ {
+ "type": "string",
+ "format": "date-time"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Created At"
+ },
+ "modified_at": {
+ "anyOf": [
+ {
+ "type": "string",
+ "format": "date-time"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Modified At"
+ },
+ "created_by": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Created By"
}
},
"type": "object",
"required": [
- "created_at",
- "modified_at",
- "artifact_id",
- "artifact_type",
- "uri",
- "organization_id"
- ],
- "title": "Artifact"
- },
- "ArtifactType": {
- "type": "string",
- "enum": [
- "recording",
- "audio",
- "session_replay",
- "browser_console_log",
- "skyvern_log",
- "skyvern_log_raw",
- "screenshot",
- "screenshot_llm",
- "screenshot_action",
- "screenshot_final",
- "llm_prompt",
- "llm_request",
- "llm_response",
- "llm_response_parsed",
- "llm_response_rendered",
- "visible_elements_id_css_map",
- "visible_elements_id_frame_map",
- "visible_elements_tree",
- "visible_elements_tree_trimmed",
- "visible_elements_tree_in_prompt",
- "hashed_href_map",
- "visible_elements_id_xpath_map",
- "html",
- "html_scrape",
- "html_action",
- "trace",
- "har",
- "script_file",
- "pdf",
- "step_archive",
- "task_archive",
- "download"
+ "action_type"
],
- "title": "ArtifactType"
+ "title": "Action"
},
- "AzureSecretParameter": {
+ "ActionBlock": {
"properties": {
- "parameter_type": {
+ "label": {
"type": "string",
- "const": "azure_secret",
- "title": "Parameter Type",
- "default": "azure_secret"
+ "title": "Label",
+ "description": "Author-facing identifier for a block; unique within a workflow."
},
- "key": {
+ "next_block_label": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Next Block Label",
+ "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
+ },
+ "block_type": {
"type": "string",
- "title": "Key"
+ "const": "action",
+ "title": "Block Type",
+ "default": "action"
+ },
+ "output_parameter": {
+ "$ref": "#/components/schemas/OutputParameter"
+ },
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
+ },
+ "model": {
+ "anyOf": [
+ {
+ "additionalProperties": true,
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Model"
+ },
+ "disable_cache": {
+ "type": "boolean",
+ "title": "Disable Cache",
+ "default": false
+ },
+ "ignore_workflow_system_prompt": {
+ "type": "boolean",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
+ },
+ "next_loop_on_failure": {
+ "type": "boolean",
+ "title": "Next Loop On Failure",
+ "default": false
+ },
+ "task_type": {
+ "type": "string",
+ "title": "Task Type",
+ "default": "general"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Url"
+ },
+ "title": {
+ "type": "string",
+ "title": "Title",
+ "default": ""
},
- "description": {
+ "engine": {
+ "$ref": "#/components/schemas/RunEngine",
+ "default": "skyvern-1.0"
+ },
+ "complete_criterion": {
"anyOf": [
{
"type": "string"
@@ -8560,68 +6686,51 @@
"type": "null"
}
],
- "title": "Description"
- },
- "azure_secret_parameter_id": {
- "type": "string",
- "title": "Azure Secret Parameter Id"
- },
- "workflow_id": {
- "type": "string",
- "title": "Workflow Id"
- },
- "azure_key": {
- "type": "string",
- "title": "Azure Key"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
+ "title": "Complete Criterion"
},
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
+ "terminate_criterion": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Terminate Criterion"
},
- "deleted_at": {
+ "navigation_goal": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Deleted At"
- }
- },
- "type": "object",
- "required": [
- "key",
- "azure_secret_parameter_id",
- "workflow_id",
- "azure_key",
- "created_at",
- "modified_at"
- ],
- "title": "AzureSecretParameter"
- },
- "AzureVaultCredentialParameter": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "azure_vault_credential",
- "title": "Parameter Type",
- "default": "azure_vault_credential"
+ "title": "Navigation Goal"
},
- "key": {
- "type": "string",
- "title": "Key"
+ "data_extraction_goal": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Data Extraction Goal"
},
- "description": {
+ "data_schema": {
"anyOf": [
+ {
+ "additionalProperties": true,
+ "type": "object"
+ },
+ {
+ "items": {},
+ "type": "array"
+ },
{
"type": "string"
},
@@ -8629,29 +6738,102 @@
"type": "null"
}
],
- "title": "Description"
+ "title": "Data Schema"
},
- "azure_vault_credential_parameter_id": {
- "type": "string",
- "title": "Azure Vault Credential Parameter Id"
+ "error_code_mapping": {
+ "anyOf": [
+ {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Error Code Mapping"
},
- "workflow_id": {
- "type": "string",
- "title": "Workflow Id"
+ "max_retries": {
+ "type": "integer",
+ "title": "Max Retries",
+ "default": 0
},
- "vault_name": {
- "type": "string",
- "title": "Vault Name"
+ "max_steps_per_run": {
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Max Steps Per Run"
},
- "username_key": {
- "type": "string",
- "title": "Username Key"
+ "parameters": {
+ "items": {
+ "oneOf": [
+ {
+ "$ref": "#/components/schemas/WorkflowParameter"
+ },
+ {
+ "$ref": "#/components/schemas/ContextParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AWSSecretParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AzureSecretParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
+ },
+ {
+ "$ref": "#/components/schemas/OnePasswordCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AzureVaultCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/OutputParameter"
+ },
+ {
+ "$ref": "#/components/schemas/CredentialParameter"
+ }
+ ],
+ "discriminator": {
+ "propertyName": "parameter_type",
+ "mapping": {
+ "aws_secret": "#/components/schemas/AWSSecretParameter",
+ "azure_secret": "#/components/schemas/AzureSecretParameter",
+ "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
+ "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
+ "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
+ "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
+ "context": "#/components/schemas/ContextParameter",
+ "credential": "#/components/schemas/CredentialParameter",
+ "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
+ "output": "#/components/schemas/OutputParameter",
+ "workflow": "#/components/schemas/WorkflowParameter"
+ }
+ }
+ },
+ "type": "array",
+ "title": "Parameters",
+ "default": []
},
- "password_key": {
- "type": "string",
- "title": "Password Key"
+ "complete_on_download": {
+ "type": "boolean",
+ "title": "Complete On Download",
+ "default": false
},
- "totp_secret_key": {
+ "download_suffix": {
"anyOf": [
{
"type": "string"
@@ -8660,80 +6842,57 @@
"type": "null"
}
],
- "title": "Totp Secret Key"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
+ "title": "Download Suffix"
},
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
+ "totp_verification_url": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Totp Verification Url"
},
- "deleted_at": {
+ "totp_identifier": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Deleted At"
- }
- },
- "type": "object",
- "required": [
- "key",
- "azure_vault_credential_parameter_id",
- "workflow_id",
- "vault_name",
- "username_key",
- "password_key",
- "created_at",
- "modified_at"
- ],
- "title": "AzureVaultCredentialParameter"
- },
- "AzureVaultCredentialParameterYAML": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "azure_vault_credential",
- "title": "Parameter Type",
- "default": "azure_vault_credential"
+ "title": "Totp Identifier"
},
- "key": {
- "type": "string",
- "title": "Key"
+ "complete_verification": {
+ "type": "boolean",
+ "title": "Complete Verification",
+ "default": true
+ },
+ "include_action_history_in_verification": {
+ "type": "boolean",
+ "title": "Include Action History In Verification",
+ "default": false
},
- "description": {
+ "download_timeout": {
"anyOf": [
{
- "type": "string"
+ "type": "number"
},
{
"type": "null"
}
],
- "title": "Description"
- },
- "vault_name": {
- "type": "string",
- "title": "Vault Name"
- },
- "username_key": {
- "type": "string",
- "title": "Username Key"
+ "title": "Download Timeout"
},
- "password_key": {
- "type": "string",
- "title": "Password Key"
+ "include_extracted_text": {
+ "type": "boolean",
+ "title": "Include Extracted Text",
+ "default": true
},
- "totp_secret_key": {
+ "selector": {
"anyOf": [
{
"type": "string"
@@ -8742,31 +6901,34 @@
"type": "null"
}
],
- "title": "Totp Secret Key"
+ "title": "Selector"
+ },
+ "ai_fallback": {
+ "$ref": "#/components/schemas/AIFallbackMode",
+ "default": "fallback"
}
},
"type": "object",
"required": [
- "key",
- "vault_name",
- "username_key",
- "password_key"
+ "label",
+ "output_parameter"
],
- "title": "AzureVaultCredentialParameterYAML"
+ "title": "ActionBlock"
},
- "BitwardenCreditCardDataParameter": {
+ "ActionBlockYAML": {
"properties": {
- "parameter_type": {
+ "block_type": {
"type": "string",
- "const": "bitwarden_credit_card_data",
- "title": "Parameter Type",
- "default": "bitwarden_credit_card_data"
+ "const": "action",
+ "title": "Block Type",
+ "default": "action"
},
- "key": {
+ "label": {
"type": "string",
- "title": "Key"
+ "title": "Label",
+ "description": "Author-facing identifier; must be unique per workflow."
},
- "description": {
+ "next_block_label": {
"anyOf": [
{
"type": "string"
@@ -8775,87 +6937,37 @@
"type": "null"
}
],
- "title": "Description"
- },
- "bitwarden_credit_card_data_parameter_id": {
- "type": "string",
- "title": "Bitwarden Credit Card Data Parameter Id"
- },
- "workflow_id": {
- "type": "string",
- "title": "Workflow Id"
- },
- "bitwarden_client_id_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Id Aws Secret Key"
- },
- "bitwarden_client_secret_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Secret Aws Secret Key"
- },
- "bitwarden_master_password_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Master Password Aws Secret Key"
- },
- "bitwarden_collection_id": {
- "type": "string",
- "title": "Bitwarden Collection Id"
- },
- "bitwarden_item_id": {
- "type": "string",
- "title": "Bitwarden Item Id"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
+ "title": "Next Block Label",
+ "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
},
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
},
- "deleted_at": {
+ "model": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Deleted At"
- }
- },
- "type": "object",
- "required": [
- "key",
- "bitwarden_credit_card_data_parameter_id",
- "workflow_id",
- "bitwarden_client_id_aws_secret_key",
- "bitwarden_client_secret_aws_secret_key",
- "bitwarden_master_password_aws_secret_key",
- "bitwarden_collection_id",
- "bitwarden_item_id",
- "created_at",
- "modified_at"
- ],
- "title": "BitwardenCreditCardDataParameter"
- },
- "BitwardenCreditCardDataParameterYAML": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "bitwarden_credit_card_data",
- "title": "Parameter Type",
- "default": "bitwarden_credit_card_data"
+ "title": "Model"
},
- "key": {
- "type": "string",
- "title": "Key"
+ "ignore_workflow_system_prompt": {
+ "type": "boolean",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
},
- "description": {
+ "next_loop_on_failure": {
+ "type": "boolean",
+ "title": "Next Loop On Failure",
+ "default": false
+ },
+ "url": {
"anyOf": [
{
"type": "string"
@@ -8864,53 +6976,18 @@
"type": "null"
}
],
- "title": "Description"
- },
- "bitwarden_client_id_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Id Aws Secret Key"
- },
- "bitwarden_client_secret_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Secret Aws Secret Key"
- },
- "bitwarden_master_password_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Master Password Aws Secret Key"
- },
- "bitwarden_collection_id": {
- "type": "string",
- "title": "Bitwarden Collection Id"
+ "title": "Url"
},
- "bitwarden_item_id": {
- "type": "string",
- "title": "Bitwarden Item Id"
- }
- },
- "type": "object",
- "required": [
- "key",
- "bitwarden_client_id_aws_secret_key",
- "bitwarden_client_secret_aws_secret_key",
- "bitwarden_master_password_aws_secret_key",
- "bitwarden_collection_id",
- "bitwarden_item_id"
- ],
- "title": "BitwardenCreditCardDataParameterYAML"
- },
- "BitwardenLoginCredentialParameter": {
- "properties": {
- "parameter_type": {
+ "title": {
"type": "string",
- "const": "bitwarden_login_credential",
- "title": "Parameter Type",
- "default": "bitwarden_login_credential"
+ "title": "Title",
+ "default": ""
},
- "key": {
- "type": "string",
- "title": "Key"
+ "engine": {
+ "$ref": "#/components/schemas/RunEngine",
+ "default": "skyvern-1.0"
},
- "description": {
+ "navigation_goal": {
"anyOf": [
{
"type": "string"
@@ -8919,40 +6996,62 @@
"type": "null"
}
],
- "title": "Description"
- },
- "bitwarden_login_credential_parameter_id": {
- "type": "string",
- "title": "Bitwarden Login Credential Parameter Id"
+ "title": "Navigation Goal"
},
- "workflow_id": {
- "type": "string",
- "title": "Workflow Id"
+ "selector": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Selector"
},
- "bitwarden_client_id_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Id Aws Secret Key"
+ "ai_fallback": {
+ "$ref": "#/components/schemas/AIFallbackMode",
+ "default": "fallback"
},
- "bitwarden_client_secret_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Secret Aws Secret Key"
+ "error_code_mapping": {
+ "anyOf": [
+ {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Error Code Mapping"
},
- "bitwarden_master_password_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Master Password Aws Secret Key"
+ "max_retries": {
+ "type": "integer",
+ "title": "Max Retries",
+ "default": 0
},
- "url_parameter_key": {
+ "parameter_keys": {
"anyOf": [
{
- "type": "string"
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
},
{
"type": "null"
}
],
- "title": "Url Parameter Key"
+ "title": "Parameter Keys"
+ },
+ "complete_on_download": {
+ "type": "boolean",
+ "title": "Complete On Download",
+ "default": false
},
- "bitwarden_collection_id": {
+ "download_suffix": {
"anyOf": [
{
"type": "string"
@@ -8961,9 +7060,9 @@
"type": "null"
}
],
- "title": "Bitwarden Collection Id"
+ "title": "Download Suffix"
},
- "bitwarden_item_id": {
+ "totp_verification_url": {
"anyOf": [
{
"type": "string"
@@ -8972,80 +7071,104 @@
"type": "null"
}
],
- "title": "Bitwarden Item Id"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
- },
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
+ "title": "Totp Verification Url"
},
- "deleted_at": {
+ "totp_identifier": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Deleted At"
+ "title": "Totp Identifier"
+ },
+ "disable_cache": {
+ "type": "boolean",
+ "title": "Disable Cache",
+ "default": false
}
},
"type": "object",
"required": [
- "key",
- "bitwarden_login_credential_parameter_id",
- "workflow_id",
- "bitwarden_client_id_aws_secret_key",
- "bitwarden_client_secret_aws_secret_key",
- "bitwarden_master_password_aws_secret_key",
- "created_at",
- "modified_at"
+ "label"
],
- "title": "BitwardenLoginCredentialParameter"
+ "title": "ActionBlockYAML"
},
- "BitwardenLoginCredentialParameterYAML": {
+ "ActionStatus": {
+ "type": "string",
+ "enum": [
+ "pending",
+ "skipped",
+ "failed",
+ "completed"
+ ],
+ "title": "ActionStatus"
+ },
+ "ActionType": {
+ "type": "string",
+ "enum": [
+ "click",
+ "input_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"
+ ],
+ "title": "ActionType"
+ },
+ "Artifact": {
"properties": {
- "parameter_type": {
+ "created_at": {
"type": "string",
- "const": "bitwarden_login_credential",
- "title": "Parameter Type",
- "default": "bitwarden_login_credential"
+ "title": "Created At",
+ "description": "The creation datetime of the task.",
+ "examples": [
+ "2023-01-01T00:00:00Z"
+ ]
},
- "key": {
+ "modified_at": {
"type": "string",
- "title": "Key"
- },
- "description": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Description"
+ "title": "Modified At",
+ "description": "The modification datetime of the task.",
+ "examples": [
+ "2023-01-01T00:00:00Z"
+ ]
},
- "bitwarden_client_id_aws_secret_key": {
+ "artifact_id": {
"type": "string",
- "title": "Bitwarden Client Id Aws Secret Key"
+ "title": "Artifact Id"
},
- "bitwarden_client_secret_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Secret Aws Secret Key"
+ "artifact_type": {
+ "$ref": "#/components/schemas/ArtifactType"
},
- "bitwarden_master_password_aws_secret_key": {
+ "uri": {
"type": "string",
- "title": "Bitwarden Master Password Aws Secret Key"
+ "title": "Uri"
},
- "url_parameter_key": {
+ "bundle_key": {
"anyOf": [
{
"type": "string"
@@ -9054,9 +7177,9 @@
"type": "null"
}
],
- "title": "Url Parameter Key"
+ "title": "Bundle Key"
},
- "bitwarden_collection_id": {
+ "checksum": {
"anyOf": [
{
"type": "string"
@@ -9065,42 +7188,20 @@
"type": "null"
}
],
- "title": "Bitwarden Collection Id"
+ "title": "Checksum"
},
- "bitwarden_item_id": {
+ "file_size": {
"anyOf": [
{
- "type": "string"
+ "type": "integer"
},
{
"type": "null"
}
],
- "title": "Bitwarden Item Id"
- }
- },
- "type": "object",
- "required": [
- "key",
- "bitwarden_client_id_aws_secret_key",
- "bitwarden_client_secret_aws_secret_key",
- "bitwarden_master_password_aws_secret_key"
- ],
- "title": "BitwardenLoginCredentialParameterYAML"
- },
- "BitwardenSensitiveInformationParameter": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "bitwarden_sensitive_information",
- "title": "Parameter Type",
- "default": "bitwarden_sensitive_information"
- },
- "key": {
- "type": "string",
- "title": "Key"
+ "title": "File Size"
},
- "description": {
+ "task_id": {
"anyOf": [
{
"type": "string"
@@ -9109,95 +7210,31 @@
"type": "null"
}
],
- "title": "Description"
- },
- "bitwarden_sensitive_information_parameter_id": {
- "type": "string",
- "title": "Bitwarden Sensitive Information Parameter Id"
- },
- "workflow_id": {
- "type": "string",
- "title": "Workflow Id"
- },
- "bitwarden_client_id_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Id Aws Secret Key"
- },
- "bitwarden_client_secret_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Secret Aws Secret Key"
- },
- "bitwarden_master_password_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Master Password Aws Secret Key"
- },
- "bitwarden_collection_id": {
- "type": "string",
- "title": "Bitwarden Collection Id"
- },
- "bitwarden_identity_key": {
- "type": "string",
- "title": "Bitwarden Identity Key"
- },
- "bitwarden_identity_fields": {
- "items": {
- "type": "string"
- },
- "type": "array",
- "title": "Bitwarden Identity Fields"
- },
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
- },
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
+ "title": "Task Id"
},
- "deleted_at": {
+ "step_id": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Deleted At"
- }
- },
- "type": "object",
- "required": [
- "key",
- "bitwarden_sensitive_information_parameter_id",
- "workflow_id",
- "bitwarden_client_id_aws_secret_key",
- "bitwarden_client_secret_aws_secret_key",
- "bitwarden_master_password_aws_secret_key",
- "bitwarden_collection_id",
- "bitwarden_identity_key",
- "bitwarden_identity_fields",
- "created_at",
- "modified_at"
- ],
- "title": "BitwardenSensitiveInformationParameter"
- },
- "BitwardenSensitiveInformationParameterYAML": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "bitwarden_sensitive_information",
- "title": "Parameter Type",
- "default": "bitwarden_sensitive_information"
+ "title": "Step Id"
},
- "key": {
- "type": "string",
- "title": "Key"
+ "workflow_run_id": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Workflow Run Id"
},
- "description": {
+ "workflow_run_block_id": {
"anyOf": [
{
"type": "string"
@@ -9206,130 +7243,20 @@
"type": "null"
}
],
- "title": "Description"
- },
- "bitwarden_client_id_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Id Aws Secret Key"
- },
- "bitwarden_client_secret_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Client Secret Aws Secret Key"
- },
- "bitwarden_master_password_aws_secret_key": {
- "type": "string",
- "title": "Bitwarden Master Password Aws Secret Key"
- },
- "bitwarden_collection_id": {
- "type": "string",
- "title": "Bitwarden Collection Id"
- },
- "bitwarden_identity_key": {
- "type": "string",
- "title": "Bitwarden Identity Key"
- },
- "bitwarden_identity_fields": {
- "items": {
- "type": "string"
- },
- "type": "array",
- "title": "Bitwarden Identity Fields"
- }
- },
- "type": "object",
- "required": [
- "key",
- "bitwarden_client_id_aws_secret_key",
- "bitwarden_client_secret_aws_secret_key",
- "bitwarden_master_password_aws_secret_key",
- "bitwarden_collection_id",
- "bitwarden_identity_key",
- "bitwarden_identity_fields"
- ],
- "title": "BitwardenSensitiveInformationParameterYAML"
- },
- "BlockType": {
- "type": "string",
- "enum": [
- "task",
- "task_v2",
- "for_loop",
- "while_loop",
- "conditional",
- "code",
- "text_prompt",
- "download_to_s3",
- "upload_to_s3",
- "file_upload",
- "send_email",
- "file_url_parser",
- "validation",
- "action",
- "navigation",
- "extraction",
- "login",
- "wait",
- "file_download",
- "goto_url",
- "pdf_parser",
- "http_request",
- "human_interaction",
- "print_page",
- "workflow_trigger",
- "google_sheets_read",
- "google_sheets_write",
- "pdf_fill",
- "split_pdf",
- "email_inbox"
- ],
- "title": "BlockType"
- },
- "Body_upload_file_v1_upload_file_post": {
- "properties": {
- "file": {
- "type": "string",
- "contentMediaType": "application/octet-stream",
- "title": "File"
- }
- },
- "type": "object",
- "required": [
- "file"
- ],
- "title": "Body_upload_file_v1_upload_file_post"
- },
- "BranchCondition": {
- "properties": {
- "id": {
- "type": "string",
- "title": "Id"
+ "title": "Workflow Run Block Id"
},
- "criteria": {
+ "run_id": {
"anyOf": [
{
- "oneOf": [
- {
- "$ref": "#/components/schemas/JinjaBranchCriteria"
- },
- {
- "$ref": "#/components/schemas/PromptBranchCriteria"
- }
- ],
- "discriminator": {
- "propertyName": "criteria_type",
- "mapping": {
- "jinja2_template": "#/components/schemas/JinjaBranchCriteria",
- "prompt": "#/components/schemas/PromptBranchCriteria"
- }
- }
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Criteria"
+ "title": "Run Id"
},
- "next_block_label": {
+ "browser_session_id": {
"anyOf": [
{
"type": "string"
@@ -9338,9 +7265,9 @@
"type": "null"
}
],
- "title": "Next Block Label"
+ "title": "Browser Session Id"
},
- "description": {
+ "observer_cruise_id": {
"anyOf": [
{
"type": "string"
@@ -9349,31 +7276,20 @@
"type": "null"
}
],
- "title": "Description"
+ "title": "Observer Cruise Id"
},
- "is_default": {
- "type": "boolean",
- "title": "Is Default",
- "default": false
- }
- },
- "type": "object",
- "title": "BranchCondition",
- "description": "Represents a single conditional branch edge within a ConditionalBlock."
- },
- "BranchConditionYAML": {
- "properties": {
- "criteria": {
+ "observer_thought_id": {
"anyOf": [
{
- "$ref": "#/components/schemas/BranchCriteriaYAML"
+ "type": "string"
},
{
"type": "null"
}
- ]
+ ],
+ "title": "Observer Thought Id"
},
- "next_block_label": {
+ "ai_suggestion_id": {
"anyOf": [
{
"type": "string"
@@ -9382,9 +7298,9 @@
"type": "null"
}
],
- "title": "Next Block Label"
+ "title": "Ai Suggestion Id"
},
- "description": {
+ "signed_url": {
"anyOf": [
{
"type": "string"
@@ -9393,63 +7309,147 @@
"type": "null"
}
],
- "title": "Description"
+ "title": "Signed Url"
},
- "is_default": {
+ "archived": {
"type": "boolean",
- "title": "Is Default",
+ "title": "Archived",
"default": false
+ },
+ "organization_id": {
+ "type": "string",
+ "title": "Organization Id"
}
},
"type": "object",
- "title": "BranchConditionYAML"
+ "required": [
+ "created_at",
+ "modified_at",
+ "artifact_id",
+ "artifact_type",
+ "uri",
+ "organization_id"
+ ],
+ "title": "Artifact"
},
- "BranchCriteriaYAML": {
+ "ArtifactType": {
+ "type": "string",
+ "enum": [
+ "recording",
+ "audio",
+ "session_replay",
+ "browser_console_log",
+ "skyvern_log",
+ "skyvern_log_raw",
+ "screenshot",
+ "screenshot_llm",
+ "screenshot_action",
+ "screenshot_final",
+ "llm_prompt",
+ "llm_request",
+ "llm_response",
+ "llm_response_parsed",
+ "llm_response_rendered",
+ "visible_elements_id_css_map",
+ "visible_elements_id_frame_map",
+ "visible_elements_tree",
+ "visible_elements_tree_trimmed",
+ "visible_elements_tree_in_prompt",
+ "hashed_href_map",
+ "visible_elements_id_xpath_map",
+ "html",
+ "html_scrape",
+ "html_action",
+ "trace",
+ "har",
+ "script_file",
+ "pdf",
+ "step_archive",
+ "task_archive",
+ "download"
+ ],
+ "title": "ArtifactType"
+ },
+ "AzureSecretParameter": {
"properties": {
- "criteria_type": {
+ "parameter_type": {
"type": "string",
- "enum": [
- "jinja2_template",
- "prompt"
+ "const": "azure_secret",
+ "title": "Parameter Type",
+ "default": "azure_secret"
+ },
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
],
- "title": "Criteria Type",
- "default": "jinja2_template"
+ "title": "Description"
},
- "expression": {
+ "azure_secret_parameter_id": {
+ "type": "string",
+ "title": "Azure Secret Parameter Id"
+ },
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
+ },
+ "azure_key": {
+ "type": "string",
+ "title": "Azure Key"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At"
+ },
+ "modified_at": {
"type": "string",
- "title": "Expression"
+ "format": "date-time",
+ "title": "Modified At"
},
- "description": {
+ "deleted_at": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Description"
+ "title": "Deleted At"
}
},
"type": "object",
"required": [
- "expression"
+ "key",
+ "azure_secret_parameter_id",
+ "workflow_id",
+ "azure_key",
+ "created_at",
+ "modified_at"
],
- "title": "BranchCriteriaYAML"
+ "title": "AzureSecretParameter"
},
- "BrowserProfile": {
+ "AzureVaultCredentialParameter": {
"properties": {
- "browser_profile_id": {
- "type": "string",
- "title": "Browser Profile Id"
- },
- "organization_id": {
+ "parameter_type": {
"type": "string",
- "title": "Organization Id"
+ "const": "azure_vault_credential",
+ "title": "Parameter Type",
+ "default": "azure_vault_credential"
},
- "name": {
+ "key": {
"type": "string",
- "title": "Name"
+ "title": "Key"
},
"description": {
"anyOf": [
@@ -9462,63 +7462,27 @@
],
"title": "Description"
},
- "source_browser_type": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Source Browser Type"
+ "azure_vault_credential_parameter_id": {
+ "type": "string",
+ "title": "Azure Vault Credential Parameter Id"
},
- "proxy_location": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/ProxyLocation"
- },
- {
- "$ref": "#/components/schemas/GeoTarget"
- },
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Proxy Location"
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
},
- "proxy_session_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Proxy Session Id"
+ "vault_name": {
+ "type": "string",
+ "title": "Vault Name"
},
- "is_managed": {
- "type": "boolean",
- "title": "Is Managed",
- "default": false
+ "username_key": {
+ "type": "string",
+ "title": "Username Key"
},
- "workflow_permanent_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Workflow Permanent Id"
+ "password_key": {
+ "type": "string",
+ "title": "Password Key"
},
- "browser_profile_key_digest": {
+ "totp_secret_key": {
"anyOf": [
{
"type": "string"
@@ -9527,7 +7491,7 @@
"type": "null"
}
],
- "title": "Browser Profile Key Digest"
+ "title": "Totp Secret Key"
},
"created_at": {
"type": "string",
@@ -9554,49 +7518,30 @@
},
"type": "object",
"required": [
- "browser_profile_id",
- "organization_id",
- "name",
+ "key",
+ "azure_vault_credential_parameter_id",
+ "workflow_id",
+ "vault_name",
+ "username_key",
+ "password_key",
"created_at",
"modified_at"
],
- "title": "BrowserProfile"
+ "title": "AzureVaultCredentialParameter"
},
- "BrowserSessionResponse": {
+ "AzureVaultCredentialParameterYAML": {
"properties": {
- "browser_session_id": {
+ "parameter_type": {
"type": "string",
- "title": "Browser Session Id",
- "description": "Unique identifier for the browser session. browser_session_id starts with `pbs_`.",
- "examples": [
- "pbs_123456"
- ]
+ "const": "azure_vault_credential",
+ "title": "Parameter Type",
+ "default": "azure_vault_credential"
},
- "organization_id": {
+ "key": {
"type": "string",
- "title": "Organization Id",
- "description": "ID of the organization that owns this session"
- },
- "status": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Status",
- "description": "Current status of the browser session",
- "examples": [
- "created",
- "running",
- "completed",
- "failed",
- "timeout"
- ]
+ "title": "Key"
},
- "runnable_type": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -9605,62 +7550,21 @@
"type": "null"
}
],
- "title": "Runnable Type",
- "description": "Type of the current runnable associated with this session (workflow, task etc)",
- "examples": [
- "task",
- "workflow_run"
- ]
+ "title": "Description"
},
- "runnable_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Runnable Id",
- "description": "ID of the current runnable",
- "examples": [
- "tsk_123456",
- "wr_123456"
- ]
+ "vault_name": {
+ "type": "string",
+ "title": "Vault Name"
},
- "timeout": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Timeout",
- "description": "Timeout in minutes for the session. Timeout is applied after the session is started. Defaults to 60 minutes.",
- "examples": [
- 60,
- 120
- ]
+ "username_key": {
+ "type": "string",
+ "title": "Username Key"
},
- "browser_address": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Browser Address",
- "description": "Url for connecting to the browser",
- "examples": [
- "http://localhost:9222",
- "https://3.12.10.11/browser/123456"
- ]
+ "password_key": {
+ "type": "string",
+ "title": "Password Key"
},
- "app_url": {
+ "totp_secret_key": {
"anyOf": [
{
"type": "string"
@@ -9669,63 +7573,120 @@
"type": "null"
}
],
- "title": "App Url",
- "description": "Url for the browser session page",
- "examples": [
- "https://app.skyvern.com/browser-session/pbs_123456"
- ]
+ "title": "Totp Secret Key"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "vault_name",
+ "username_key",
+ "password_key"
+ ],
+ "title": "AzureVaultCredentialParameterYAML"
+ },
+ "BitwardenCreditCardDataParameter": {
+ "properties": {
+ "parameter_type": {
+ "type": "string",
+ "const": "bitwarden_credit_card_data",
+ "title": "Parameter Type",
+ "default": "bitwarden_credit_card_data"
},
- "extensions": {
- "anyOf": [
- {
- "items": {
- "$ref": "#/components/schemas/Extensions"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Extensions",
- "description": "A list of extensions installed in the browser session."
+ "key": {
+ "type": "string",
+ "title": "Key"
},
- "browser_type": {
+ "description": {
"anyOf": [
{
- "$ref": "#/components/schemas/PersistentBrowserType"
+ "type": "string"
},
{
"type": "null"
}
],
- "description": "The type of browser used for the session."
+ "title": "Description"
},
- "browser_profile_id": {
+ "bitwarden_credit_card_data_parameter_id": {
+ "type": "string",
+ "title": "Bitwarden Credit Card Data Parameter Id"
+ },
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
+ },
+ "bitwarden_client_id_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Id Aws Secret Key"
+ },
+ "bitwarden_client_secret_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Secret Aws Secret Key"
+ },
+ "bitwarden_master_password_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Master Password Aws Secret Key"
+ },
+ "bitwarden_collection_id": {
+ "type": "string",
+ "title": "Bitwarden Collection Id"
+ },
+ "bitwarden_item_id": {
+ "type": "string",
+ "title": "Bitwarden Item Id"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At"
+ },
+ "modified_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Modified At"
+ },
+ "deleted_at": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Browser Profile Id",
- "description": "ID of the browser profile loaded into this session, if any. browser_profile_id starts with `bp_`."
- },
- "generate_browser_profile": {
- "type": "boolean",
- "title": "Generate Browser Profile",
- "description": "Whether this session's browser profile will be saved when it ends so it can become a reusable browser profile.",
- "default": false
+ "title": "Deleted At"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "bitwarden_credit_card_data_parameter_id",
+ "workflow_id",
+ "bitwarden_client_id_aws_secret_key",
+ "bitwarden_client_secret_aws_secret_key",
+ "bitwarden_master_password_aws_secret_key",
+ "bitwarden_collection_id",
+ "bitwarden_item_id",
+ "created_at",
+ "modified_at"
+ ],
+ "title": "BitwardenCreditCardDataParameter"
+ },
+ "BitwardenCreditCardDataParameterYAML": {
+ "properties": {
+ "parameter_type": {
+ "type": "string",
+ "const": "bitwarden_credit_card_data",
+ "title": "Parameter Type",
+ "default": "bitwarden_credit_card_data"
},
- "vnc_streaming_supported": {
- "type": "boolean",
- "title": "Vnc Streaming Supported",
- "description": "Whether the browser session supports VNC streaming",
- "default": false
+ "key": {
+ "type": "string",
+ "title": "Key"
},
- "download_path": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -9734,169 +7695,165 @@
"type": "null"
}
],
- "title": "Download Path",
- "description": "The path where the browser session downloads files"
+ "title": "Description"
},
- "downloaded_files": {
+ "bitwarden_client_id_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Id Aws Secret Key"
+ },
+ "bitwarden_client_secret_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Secret Aws Secret Key"
+ },
+ "bitwarden_master_password_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Master Password Aws Secret Key"
+ },
+ "bitwarden_collection_id": {
+ "type": "string",
+ "title": "Bitwarden Collection Id"
+ },
+ "bitwarden_item_id": {
+ "type": "string",
+ "title": "Bitwarden Item Id"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "bitwarden_client_id_aws_secret_key",
+ "bitwarden_client_secret_aws_secret_key",
+ "bitwarden_master_password_aws_secret_key",
+ "bitwarden_collection_id",
+ "bitwarden_item_id"
+ ],
+ "title": "BitwardenCreditCardDataParameterYAML"
+ },
+ "BitwardenLoginCredentialParameter": {
+ "properties": {
+ "parameter_type": {
+ "type": "string",
+ "const": "bitwarden_login_credential",
+ "title": "Parameter Type",
+ "default": "bitwarden_login_credential"
+ },
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
- "items": {
- "$ref": "#/components/schemas/FileInfo"
- },
- "type": "array"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Downloaded Files",
- "description": "The list of files downloaded by the browser session"
+ "title": "Description"
},
- "recordings": {
+ "bitwarden_login_credential_parameter_id": {
+ "type": "string",
+ "title": "Bitwarden Login Credential Parameter Id"
+ },
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
+ },
+ "bitwarden_client_id_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Id Aws Secret Key"
+ },
+ "bitwarden_client_secret_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Secret Aws Secret Key"
+ },
+ "bitwarden_master_password_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Master Password Aws Secret Key"
+ },
+ "url_parameter_key": {
"anyOf": [
{
- "items": {
- "$ref": "#/components/schemas/FileInfo"
- },
- "type": "array"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Recordings",
- "description": "The list of video recordings from the browser session"
+ "title": "Url Parameter Key"
},
- "started_at": {
+ "bitwarden_collection_id": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Started At",
- "description": "Timestamp when the session was started"
+ "title": "Bitwarden Collection Id"
},
- "completed_at": {
+ "bitwarden_item_id": {
"anyOf": [
{
- "type": "string",
- "format": "date-time"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Completed At",
- "description": "Timestamp when the session was completed"
+ "title": "Bitwarden Item Id"
},
"created_at": {
"type": "string",
"format": "date-time",
- "title": "Created At",
- "description": "Timestamp when the session was created (the timestamp for the initial request)"
+ "title": "Created At"
},
"modified_at": {
"type": "string",
"format": "date-time",
- "title": "Modified At",
- "description": "Timestamp when the session was last modified"
- },
- "deleted_at": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "title": "Deleted At",
- "description": "Timestamp when the session was deleted, if applicable"
- }
- },
- "type": "object",
- "required": [
- "browser_session_id",
- "organization_id",
- "created_at",
- "modified_at"
- ],
- "title": "BrowserSessionResponse",
- "description": "Response model for browser session information."
- },
- "BulkCancelRunsRequest": {
- "properties": {
- "run_ids": {
- "items": {
- "type": "string"
- },
- "type": "array",
- "maxItems": 100,
- "title": "Run Ids",
- "description": "List of run IDs to cancel"
- }
- },
- "type": "object",
- "required": [
- "run_ids"
- ],
- "title": "BulkCancelRunsRequest"
- },
- "BulkCancelRunsResponse": {
- "properties": {
- "cancelled": {
- "items": {
- "type": "string"
- },
- "type": "array",
- "title": "Cancelled",
- "description": "Run IDs that were successfully cancelled"
+ "title": "Modified At"
},
- "failed": {
- "items": {
- "type": "string"
- },
- "type": "array",
- "title": "Failed",
- "description": "Run IDs that could not be cancelled"
- }
- },
- "type": "object",
- "required": [
- "cancelled",
- "failed"
- ],
- "title": "BulkCancelRunsResponse"
- },
- "ClearOrganizationAuthTokenResponse": {
- "properties": {
- "success": {
- "type": "boolean",
- "title": "Success",
- "description": "Whether the token was cleared successfully"
+ "deleted_at": {
+ "anyOf": [
+ {
+ "type": "string",
+ "format": "date-time"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Deleted At"
}
},
"type": "object",
"required": [
- "success"
+ "key",
+ "bitwarden_login_credential_parameter_id",
+ "workflow_id",
+ "bitwarden_client_id_aws_secret_key",
+ "bitwarden_client_secret_aws_secret_key",
+ "bitwarden_master_password_aws_secret_key",
+ "created_at",
+ "modified_at"
],
- "title": "ClearOrganizationAuthTokenResponse",
- "description": "Response model for clearing an organization auth token."
+ "title": "BitwardenLoginCredentialParameter"
},
- "ClickAction": {
+ "BitwardenLoginCredentialParameterYAML": {
"properties": {
- "type": {
+ "parameter_type": {
"type": "string",
- "const": "ai_click",
- "title": "Type",
- "default": "ai_click"
+ "const": "bitwarden_login_credential",
+ "title": "Parameter Type",
+ "default": "bitwarden_login_credential"
},
- "selector": {
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
"type": "string"
@@ -9905,46 +7862,32 @@
"type": "null"
}
],
- "title": "Selector",
- "description": "CSS selector for the element",
- "default": ""
+ "title": "Description"
},
- "intention": {
+ "bitwarden_client_id_aws_secret_key": {
"type": "string",
- "title": "Intention",
- "description": "The intention or goal of the click",
- "default": ""
+ "title": "Bitwarden Client Id Aws Secret Key"
},
- "data": {
+ "bitwarden_client_secret_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Secret Aws Secret Key"
+ },
+ "bitwarden_master_password_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Master Password Aws Secret Key"
+ },
+ "url_parameter_key": {
"anyOf": [
{
"type": "string"
},
- {
- "additionalProperties": true,
- "type": "object"
- },
{
"type": "null"
}
],
- "title": "Data",
- "description": "Additional context data"
+ "title": "Url Parameter Key"
},
- "timeout": {
- "type": "number",
- "title": "Timeout",
- "description": "Timeout in milliseconds",
- "default": 10000
- }
- },
- "type": "object",
- "title": "ClickAction",
- "description": "Click action parameters."
- },
- "ClickContext": {
- "properties": {
- "thought": {
+ "bitwarden_collection_id": {
"anyOf": [
{
"type": "string"
@@ -9953,31 +7896,42 @@
"type": "null"
}
],
- "title": "Thought"
+ "title": "Bitwarden Collection Id"
},
- "single_option_click": {
+ "bitwarden_item_id": {
"anyOf": [
{
- "type": "boolean"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Single Option Click"
+ "title": "Bitwarden Item Id"
}
},
"type": "object",
- "title": "ClickContext"
+ "required": [
+ "key",
+ "bitwarden_client_id_aws_secret_key",
+ "bitwarden_client_secret_aws_secret_key",
+ "bitwarden_master_password_aws_secret_key"
+ ],
+ "title": "BitwardenLoginCredentialParameterYAML"
},
- "CodeBlock": {
+ "BitwardenSensitiveInformationParameter": {
"properties": {
- "label": {
+ "parameter_type": {
"type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
+ "const": "bitwarden_sensitive_information",
+ "title": "Parameter Type",
+ "default": "bitwarden_sensitive_information"
},
- "next_block_label": {
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
"type": "string"
@@ -9986,149 +7940,95 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
+ "title": "Description"
},
- "block_type": {
+ "bitwarden_sensitive_information_parameter_id": {
"type": "string",
- "const": "code",
- "title": "Block Type",
- "default": "code"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
+ "title": "Bitwarden Sensitive Information Parameter Id"
},
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
},
- "model": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Model"
+ "bitwarden_client_id_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Id Aws Secret Key"
},
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
+ "bitwarden_client_secret_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Secret Aws Secret Key"
},
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
+ "bitwarden_master_password_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Master Password Aws Secret Key"
},
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
+ "bitwarden_collection_id": {
+ "type": "string",
+ "title": "Bitwarden Collection Id"
},
- "code": {
+ "bitwarden_identity_key": {
"type": "string",
- "title": "Code"
+ "title": "Bitwarden Identity Key"
},
- "parameters": {
+ "bitwarden_identity_fields": {
"items": {
- "oneOf": [
- {
- "$ref": "#/components/schemas/WorkflowParameter"
- },
- {
- "$ref": "#/components/schemas/ContextParameter"
- },
- {
- "$ref": "#/components/schemas/AWSSecretParameter"
- },
- {
- "$ref": "#/components/schemas/AzureSecretParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
- },
- {
- "$ref": "#/components/schemas/OnePasswordCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/AzureVaultCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/OutputParameter"
- },
- {
- "$ref": "#/components/schemas/CredentialParameter"
- }
- ],
- "discriminator": {
- "propertyName": "parameter_type",
- "mapping": {
- "aws_secret": "#/components/schemas/AWSSecretParameter",
- "azure_secret": "#/components/schemas/AzureSecretParameter",
- "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
- "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
- "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
- "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
- "context": "#/components/schemas/ContextParameter",
- "credential": "#/components/schemas/CredentialParameter",
- "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
- "output": "#/components/schemas/OutputParameter",
- "workflow": "#/components/schemas/WorkflowParameter"
- }
- }
+ "type": "string"
},
"type": "array",
- "title": "Parameters",
- "default": []
+ "title": "Bitwarden Identity Fields"
},
- "prompt": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Prompt"
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At"
+ },
+ "modified_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Modified At"
},
- "steps": {
+ "deleted_at": {
"anyOf": [
{
- "items": {
- "$ref": "#/components/schemas/CodeBlockStep"
- },
- "type": "array"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Steps"
+ "title": "Deleted At"
}
},
"type": "object",
"required": [
- "label",
- "output_parameter",
- "code"
+ "key",
+ "bitwarden_sensitive_information_parameter_id",
+ "workflow_id",
+ "bitwarden_client_id_aws_secret_key",
+ "bitwarden_client_secret_aws_secret_key",
+ "bitwarden_master_password_aws_secret_key",
+ "bitwarden_collection_id",
+ "bitwarden_identity_key",
+ "bitwarden_identity_fields",
+ "created_at",
+ "modified_at"
],
- "title": "CodeBlock"
+ "title": "BitwardenSensitiveInformationParameter"
},
- "CodeBlockStep": {
+ "BitwardenSensitiveInformationParameterYAML": {
"properties": {
- "title": {
+ "parameter_type": {
+ "type": "string",
+ "const": "bitwarden_sensitive_information",
+ "title": "Parameter Type",
+ "default": "bitwarden_sensitive_information"
+ },
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
"type": "string"
@@ -10137,63 +8037,171 @@
"type": "null"
}
],
- "title": "Title"
+ "title": "Description"
},
- "description": {
+ "bitwarden_client_id_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Id Aws Secret Key"
+ },
+ "bitwarden_client_secret_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Client Secret Aws Secret Key"
+ },
+ "bitwarden_master_password_aws_secret_key": {
+ "type": "string",
+ "title": "Bitwarden Master Password Aws Secret Key"
+ },
+ "bitwarden_collection_id": {
+ "type": "string",
+ "title": "Bitwarden Collection Id"
+ },
+ "bitwarden_identity_key": {
+ "type": "string",
+ "title": "Bitwarden Identity Key"
+ },
+ "bitwarden_identity_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "title": "Bitwarden Identity Fields"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "bitwarden_client_id_aws_secret_key",
+ "bitwarden_client_secret_aws_secret_key",
+ "bitwarden_master_password_aws_secret_key",
+ "bitwarden_collection_id",
+ "bitwarden_identity_key",
+ "bitwarden_identity_fields"
+ ],
+ "title": "BitwardenSensitiveInformationParameterYAML"
+ },
+ "BlockType": {
+ "type": "string",
+ "enum": [
+ "task",
+ "task_v2",
+ "for_loop",
+ "while_loop",
+ "conditional",
+ "code",
+ "text_prompt",
+ "download_to_s3",
+ "upload_to_s3",
+ "file_upload",
+ "send_email",
+ "file_url_parser",
+ "validation",
+ "action",
+ "navigation",
+ "extraction",
+ "login",
+ "wait",
+ "file_download",
+ "goto_url",
+ "pdf_parser",
+ "http_request",
+ "human_interaction",
+ "print_page",
+ "workflow_trigger",
+ "google_sheets_read",
+ "google_sheets_write"
+ ],
+ "title": "BlockType"
+ },
+ "Body_upload_file_v1_upload_file_post": {
+ "properties": {
+ "file": {
+ "type": "string",
+ "contentMediaType": "application/octet-stream",
+ "title": "File"
+ }
+ },
+ "type": "object",
+ "required": [
+ "file"
+ ],
+ "title": "Body_upload_file_v1_upload_file_post"
+ },
+ "BranchCondition": {
+ "properties": {
+ "id": {
+ "type": "string",
+ "title": "Id"
+ },
+ "criteria": {
"anyOf": [
{
- "type": "string"
+ "oneOf": [
+ {
+ "$ref": "#/components/schemas/JinjaBranchCriteria"
+ },
+ {
+ "$ref": "#/components/schemas/PromptBranchCriteria"
+ }
+ ],
+ "discriminator": {
+ "propertyName": "criteria_type",
+ "mapping": {
+ "jinja2_template": "#/components/schemas/JinjaBranchCriteria",
+ "prompt": "#/components/schemas/PromptBranchCriteria"
+ }
+ }
},
{
"type": "null"
}
],
- "title": "Description"
- },
- "action_type": {
- "$ref": "#/components/schemas/ActionType",
- "default": "null_action"
+ "title": "Criteria"
},
- "line_start": {
+ "next_block_label": {
"anyOf": [
{
- "type": "integer"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Line Start"
+ "title": "Next Block Label"
},
- "line_end": {
+ "description": {
"anyOf": [
{
- "type": "integer"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Line End"
+ "title": "Description"
+ },
+ "is_default": {
+ "type": "boolean",
+ "title": "Is Default",
+ "default": false
}
},
"type": "object",
- "title": "CodeBlockStep"
+ "title": "BranchCondition",
+ "description": "Represents a single conditional branch edge within a ConditionalBlock."
},
- "CodeBlockStepYAML": {
+ "BranchConditionYAML": {
"properties": {
- "title": {
+ "criteria": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/BranchCriteriaYAML"
},
{
"type": "null"
}
- ],
- "title": "Title"
+ ]
},
- "description": {
+ "next_block_label": {
"anyOf": [
{
"type": "string"
@@ -10202,53 +8210,44 @@
"type": "null"
}
],
- "title": "Description"
- },
- "action_type": {
- "type": "string",
- "title": "Action Type",
- "default": "null_action"
+ "title": "Next Block Label"
},
- "line_start": {
+ "description": {
"anyOf": [
{
- "type": "integer"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Line Start"
+ "title": "Description"
},
- "line_end": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Line End"
+ "is_default": {
+ "type": "boolean",
+ "title": "Is Default",
+ "default": false
}
},
"type": "object",
- "title": "CodeBlockStepYAML"
+ "title": "BranchConditionYAML"
},
- "CodeBlockYAML": {
+ "BranchCriteriaYAML": {
"properties": {
- "block_type": {
+ "criteria_type": {
"type": "string",
- "const": "code",
- "title": "Block Type",
- "default": "code"
+ "enum": [
+ "jinja2_template",
+ "prompt"
+ ],
+ "title": "Criteria Type",
+ "default": "jinja2_template"
},
- "label": {
+ "expression": {
"type": "string",
- "title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
+ "title": "Expression"
},
- "next_block_label": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -10257,55 +8256,41 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
- },
- "model": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Model"
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
+ "title": "Description"
+ }
+ },
+ "type": "object",
+ "required": [
+ "expression"
+ ],
+ "title": "BranchCriteriaYAML"
+ },
+ "BrowserProfile": {
+ "properties": {
+ "browser_profile_id": {
+ "type": "string",
+ "title": "Browser Profile Id"
},
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
+ "organization_id": {
+ "type": "string",
+ "title": "Organization Id"
},
- "code": {
+ "name": {
"type": "string",
- "title": "Code"
+ "title": "Name"
},
- "parameter_keys": {
+ "description": {
"anyOf": [
{
- "items": {
- "type": "string"
- },
- "type": "array"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Parameter Keys"
+ "title": "Description"
},
- "prompt": {
+ "source_browser_type": {
"anyOf": [
{
"type": "string"
@@ -10314,38 +8299,27 @@
"type": "null"
}
],
- "title": "Prompt"
+ "title": "Source Browser Type"
},
- "steps": {
+ "proxy_location": {
"anyOf": [
{
- "items": {
- "$ref": "#/components/schemas/CodeBlockStepYAML"
- },
- "type": "array"
+ "$ref": "#/components/schemas/ProxyLocation"
+ },
+ {
+ "$ref": "#/components/schemas/GeoTarget"
+ },
+ {
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Steps"
- }
- },
- "type": "object",
- "required": [
- "label",
- "code"
- ],
- "title": "CodeBlockYAML"
- },
- "ConditionalBlock": {
- "properties": {
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
+ "title": "Proxy Location"
},
- "next_block_label": {
+ "proxy_session_id": {
"anyOf": [
{
"type": "string"
@@ -10354,80 +8328,25 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
- },
- "block_type": {
- "type": "string",
- "const": "conditional",
- "title": "Block Type",
- "default": "conditional"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
+ "title": "Proxy Session Id"
},
- "continue_on_failure": {
+ "is_managed": {
"type": "boolean",
- "title": "Continue On Failure",
+ "title": "Is Managed",
"default": false
},
- "model": {
+ "workflow_permanent_id": {
"anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Model"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "branch_conditions": {
- "items": {
- "$ref": "#/components/schemas/BranchCondition"
- },
- "type": "array",
- "title": "Branch Conditions"
- }
- },
- "type": "object",
- "required": [
- "label",
- "output_parameter"
- ],
- "title": "ConditionalBlock",
- "description": "Branching block that selects the next block label based on list-ordered conditions."
- },
- "ConditionalBlockYAML": {
- "properties": {
- "block_type": {
- "type": "string",
- "const": "conditional",
- "title": "Block Type",
- "default": "conditional"
- },
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
+ "title": "Workflow Permanent Id"
},
- "next_block_label": {
+ "browser_profile_key_digest": {
"anyOf": [
{
"type": "string"
@@ -10436,63 +8355,57 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
+ "title": "Browser Profile Key Digest"
},
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At"
},
- "model": {
+ "modified_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Modified At"
+ },
+ "deleted_at": {
"anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Model"
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "branch_conditions": {
- "items": {
- "$ref": "#/components/schemas/BranchConditionYAML"
- },
- "type": "array",
- "title": "Branch Conditions"
+ "title": "Deleted At"
}
},
"type": "object",
"required": [
- "label"
+ "browser_profile_id",
+ "organization_id",
+ "name",
+ "created_at",
+ "modified_at"
],
- "title": "ConditionalBlockYAML"
+ "title": "BrowserProfile"
},
- "ContextParameter": {
+ "BrowserSessionResponse": {
"properties": {
- "parameter_type": {
+ "browser_session_id": {
"type": "string",
- "const": "context",
- "title": "Parameter Type",
- "default": "context"
+ "title": "Browser Session Id",
+ "description": "Unique identifier for the browser session. browser_session_id starts with `pbs_`.",
+ "examples": [
+ "pbs_123456"
+ ]
},
- "key": {
+ "organization_id": {
"type": "string",
- "title": "Key"
+ "title": "Organization Id",
+ "description": "ID of the organization that owns this session"
},
- "description": {
+ "status": {
"anyOf": [
{
"type": "string"
@@ -10501,95 +8414,122 @@
"type": "null"
}
],
- "title": "Description"
+ "title": "Status",
+ "description": "Current status of the browser session",
+ "examples": [
+ "created",
+ "running",
+ "completed",
+ "failed",
+ "timeout"
+ ]
},
- "source": {
+ "runnable_type": {
"anyOf": [
{
- "$ref": "#/components/schemas/WorkflowParameter"
- },
- {
- "$ref": "#/components/schemas/ContextParameter"
- },
- {
- "$ref": "#/components/schemas/AWSSecretParameter"
- },
- {
- "$ref": "#/components/schemas/AzureSecretParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
+ "type": "string"
},
{
- "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
- },
+ "type": "null"
+ }
+ ],
+ "title": "Runnable Type",
+ "description": "Type of the current runnable associated with this session (workflow, task etc)",
+ "examples": [
+ "task",
+ "workflow_run"
+ ]
+ },
+ "runnable_id": {
+ "anyOf": [
{
- "$ref": "#/components/schemas/OnePasswordCredentialParameter"
+ "type": "string"
},
{
- "$ref": "#/components/schemas/AzureVaultCredentialParameter"
- },
+ "type": "null"
+ }
+ ],
+ "title": "Runnable Id",
+ "description": "ID of the current runnable",
+ "examples": [
+ "tsk_123456",
+ "wr_123456"
+ ]
+ },
+ "timeout": {
+ "anyOf": [
{
- "$ref": "#/components/schemas/OutputParameter"
+ "type": "integer"
},
{
- "$ref": "#/components/schemas/CredentialParameter"
+ "type": "null"
}
],
- "title": "Source"
+ "title": "Timeout",
+ "description": "Timeout in minutes for the session. Timeout is applied after the session is started. Defaults to 60 minutes.",
+ "examples": [
+ 60,
+ 120
+ ]
},
- "value": {
+ "browser_address": {
"anyOf": [
{
"type": "string"
},
{
- "type": "integer"
- },
- {
- "type": "number"
- },
+ "type": "null"
+ }
+ ],
+ "title": "Browser Address",
+ "description": "Url for connecting to the browser",
+ "examples": [
+ "http://localhost:9222",
+ "https://3.12.10.11/browser/123456"
+ ]
+ },
+ "app_url": {
+ "anyOf": [
{
- "type": "boolean"
+ "type": "string"
},
{
- "additionalProperties": true,
- "type": "object"
- },
+ "type": "null"
+ }
+ ],
+ "title": "App Url",
+ "description": "Url for the browser session page",
+ "examples": [
+ "https://app.skyvern.com/browser-session/pbs_123456"
+ ]
+ },
+ "extensions": {
+ "anyOf": [
{
- "items": {},
+ "items": {
+ "$ref": "#/components/schemas/Extensions"
+ },
"type": "array"
},
{
"type": "null"
}
],
- "title": "Value"
- }
- },
- "type": "object",
- "required": [
- "key",
- "source"
- ],
- "title": "ContextParameter"
- },
- "ContextParameterYAML": {
- "properties": {
- "parameter_type": {
- "type": "string",
- "const": "context",
- "title": "Parameter Type",
- "default": "context"
+ "title": "Extensions",
+ "description": "A list of extensions installed in the browser session."
},
- "key": {
- "type": "string",
- "title": "Key"
+ "browser_type": {
+ "anyOf": [
+ {
+ "$ref": "#/components/schemas/PersistentBrowserType"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The type of browser used for the session."
},
- "description": {
+ "browser_profile_id": {
"anyOf": [
{
"type": "string"
@@ -10598,29 +8538,22 @@
"type": "null"
}
],
- "title": "Description"
+ "title": "Browser Profile Id",
+ "description": "ID of the browser profile loaded into this session, if any. browser_profile_id starts with `bp_`."
},
- "source_parameter_key": {
- "type": "string",
- "title": "Source Parameter Key"
- }
- },
- "type": "object",
- "required": [
- "key",
- "source_parameter_key"
- ],
- "title": "ContextParameterYAML"
- },
- "CreateBrowserProfileRequest": {
- "properties": {
- "name": {
- "type": "string",
- "minLength": 1,
- "title": "Name",
- "description": "Name for the browser profile"
+ "generate_browser_profile": {
+ "type": "boolean",
+ "title": "Generate Browser Profile",
+ "description": "Whether this session's browser profile will be saved when it ends so it can become a reusable browser profile.",
+ "default": false
},
- "description": {
+ "vnc_streaming_supported": {
+ "type": "boolean",
+ "title": "Vnc Streaming Supported",
+ "description": "Whether the browser session supports VNC streaming",
+ "default": false
+ },
+ "download_path": {
"anyOf": [
{
"type": "string"
@@ -10629,230 +8562,262 @@
"type": "null"
}
],
- "title": "Description",
- "description": "Optional profile description"
+ "title": "Download Path",
+ "description": "The path where the browser session downloads files"
},
- "browser_session_id": {
+ "downloaded_files": {
"anyOf": [
{
- "type": "string",
- "minLength": 1
+ "items": {
+ "$ref": "#/components/schemas/FileInfo"
+ },
+ "type": "array"
},
{
"type": "null"
}
],
- "title": "Browser Session Id",
- "description": "Persistent browser session to convert into a profile. Omit for a blank profile."
+ "title": "Downloaded Files",
+ "description": "The list of files downloaded by the browser session"
},
- "workflow_run_id": {
+ "recordings": {
"anyOf": [
{
- "type": "string",
- "minLength": 1
+ "items": {
+ "$ref": "#/components/schemas/FileInfo"
+ },
+ "type": "array"
},
{
"type": "null"
}
],
- "title": "Workflow Run Id",
- "description": "Workflow run whose persisted session should be captured. Omit for a blank profile."
+ "title": "Recordings",
+ "description": "The list of video recordings from the browser session"
},
- "proxy_location": {
+ "started_at": {
"anyOf": [
{
- "$ref": "#/components/schemas/ProxyLocation"
+ "type": "string",
+ "format": "date-time"
},
{
- "$ref": "#/components/schemas/GeoTarget"
- },
+ "type": "null"
+ }
+ ],
+ "title": "Started At",
+ "description": "Timestamp when the session was started"
+ },
+ "completed_at": {
+ "anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Proxy Location",
- "description": "Optional proxy location for this profile's pinned proxy identity."
+ "title": "Completed At",
+ "description": "Timestamp when the session was completed"
},
- "proxy_session_id": {
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At",
+ "description": "Timestamp when the session was created (the timestamp for the initial request)"
+ },
+ "modified_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Modified At",
+ "description": "Timestamp when the session was last modified"
+ },
+ "deleted_at": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Proxy Session Id",
- "description": "Explicit sticky-session id for this profile's pinned proxy identity."
+ "title": "Deleted At",
+ "description": "Timestamp when the session was deleted, if applicable"
}
},
"type": "object",
"required": [
- "name"
+ "browser_session_id",
+ "organization_id",
+ "created_at",
+ "modified_at"
],
- "title": "CreateBrowserProfileRequest"
+ "title": "BrowserSessionResponse",
+ "description": "Response model for browser session information."
},
- "CreateBrowserSessionRequest": {
+ "BulkCancelRunsRequest": {
"properties": {
- "timeout": {
- "anyOf": [
- {
- "type": "integer",
- "maximum": 1440,
- "minimum": 5
- },
- {
- "type": "null"
- }
- ],
- "title": "Timeout",
- "description": "Timeout in minutes for the session. Timeout is applied after the session is started. Must be between 5 and 1440. Defaults to 60.",
- "default": 60
+ "run_ids": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "maxItems": 100,
+ "title": "Run Ids",
+ "description": "List of run IDs to cancel"
+ }
+ },
+ "type": "object",
+ "required": [
+ "run_ids"
+ ],
+ "title": "BulkCancelRunsRequest"
+ },
+ "BulkCancelRunsResponse": {
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "title": "Cancelled",
+ "description": "Run IDs that were successfully cancelled"
+ },
+ "failed": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "title": "Failed",
+ "description": "Run IDs that could not be cancelled"
+ }
+ },
+ "type": "object",
+ "required": [
+ "cancelled",
+ "failed"
+ ],
+ "title": "BulkCancelRunsResponse"
+ },
+ "ClickAction": {
+ "properties": {
+ "type": {
+ "type": "string",
+ "const": "ai_click",
+ "title": "Type",
+ "default": "ai_click"
},
- "proxy_location": {
+ "selector": {
"anyOf": [
{
- "$ref": "#/components/schemas/ProxyLocation"
- },
- {
- "$ref": "#/components/schemas/GeoTarget"
- },
- {
- "additionalProperties": true,
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Proxy Location",
- "description": "\nGeographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.\n\nAvailable geotargeting options:\n- RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.\n- RESIDENTIAL_ES: Spain\n- RESIDENTIAL_IE: Ireland\n- RESIDENTIAL_GB: United Kingdom\n- RESIDENTIAL_IN: India\n- RESIDENTIAL_JP: Japan\n- RESIDENTIAL_FR: France\n- RESIDENTIAL_DE: Germany\n- RESIDENTIAL_NZ: New Zealand\n- RESIDENTIAL_PH: Philippines\n- RESIDENTIAL_KR: South Korea\n- RESIDENTIAL_SA: Saudi Arabia\n- RESIDENTIAL_ZA: South Africa\n- RESIDENTIAL_AR: Argentina\n- RESIDENTIAL_AU: Australia\n- RESIDENTIAL_BR: Brazil\n- RESIDENTIAL_TR: Turkey\n- RESIDENTIAL_CA: Canada\n- RESIDENTIAL_MX: Mexico\n- RESIDENTIAL_IT: Italy\n- RESIDENTIAL_NL: Netherlands\n- RESIDENTIAL_ISP: ISP proxy\n- US-CA: California (deprecated, routes through RESIDENTIAL_ISP)\n- US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)\n- US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)\n- US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)\n- US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)\n- NONE: No proxy\n\nFor self-hosted deployments, you can pass a custom proxy URL as a dict: {\"url\": \"http://user:[email protected]:8080\"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.\n Can also be a GeoTarget object for granular city/state targeting: {\"country\": \"US\", \"subdivision\": \"CA\", \"city\": \"San Francisco\"}, or a custom proxy URL dict for self-hosted deployments: {\"url\": \"http://user:[email protected]:8080\"}"
+ "title": "Selector",
+ "description": "CSS selector for the element",
+ "default": ""
},
- "proxy_session_id": {
+ "intention": {
+ "type": "string",
+ "title": "Intention",
+ "description": "The intention or goal of the click",
+ "default": ""
+ },
+ "data": {
"anyOf": [
{
"type": "string"
},
{
- "type": "null"
- }
- ],
- "title": "Proxy Session Id",
- "description": "Opaque Skyvern-managed proxy sticky-session id for pinned Residential ISP sessions."
- },
- "extensions": {
- "anyOf": [
- {
- "items": {
- "$ref": "#/components/schemas/Extensions"
- },
- "type": "array"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Extensions",
- "description": "A list of extensions to install in the browser session."
+ "title": "Data",
+ "description": "Additional context data"
},
- "browser_type": {
+ "timeout": {
+ "type": "number",
+ "title": "Timeout",
+ "description": "Timeout in milliseconds",
+ "default": 5000
+ }
+ },
+ "type": "object",
+ "title": "ClickAction",
+ "description": "Click action parameters."
+ },
+ "ClickContext": {
+ "properties": {
+ "thought": {
"anyOf": [
{
- "$ref": "#/components/schemas/PersistentBrowserType"
+ "type": "string"
},
{
"type": "null"
}
],
- "description": "The type of browser to use for the session."
+ "title": "Thought"
},
- "browser_profile_id": {
+ "single_option_click": {
"anyOf": [
{
- "type": "string",
- "pattern": "^bp_"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "Browser Profile Id",
- "description": "ID of a browser profile to load into this session (restores cookies, localStorage, etc.). browser_profile_id starts with `bp_`."
- },
- "generate_browser_profile": {
- "type": "boolean",
- "title": "Generate Browser Profile",
- "description": "When true, the session's browser profile (cookies, localStorage, etc.) is saved to storage when the session ends so it can be turned into a reusable browser profile. Defaults to false to avoid storing profiles for sessions that never need them. Sessions started with a browser_profile_id always persist their profile regardless of this flag.",
- "default": false
+ "title": "Single Option Click"
}
},
"type": "object",
- "title": "CreateBrowserSessionRequest"
+ "title": "ClickContext"
},
- "CreateCredentialRequest": {
+ "CodeBlock": {
"properties": {
- "name": {
+ "label": {
"type": "string",
- "title": "Name",
- "description": "Name of the credential",
- "examples": [
- "Amazon Login"
- ]
- },
- "credential_type": {
- "$ref": "#/components/schemas/skyvern__forge__sdk__schemas__credentials__CredentialType",
- "description": "Type of credential to create"
- },
- "credential": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/NonEmptyPasswordCredential"
- },
- {
- "$ref": "#/components/schemas/NonEmptyCreditCardCredential"
- },
- {
- "$ref": "#/components/schemas/SecretCredential"
- }
- ],
- "title": "Credential",
- "description": "The credential data to store",
- "examples": [
- {
- "password": "securepassword123",
- "username": "[email protected]"
- }
- ]
+ "title": "Label",
+ "description": "Author-facing identifier for a block; unique within a workflow."
},
- "vault_type": {
+ "next_block_label": {
"anyOf": [
{
- "$ref": "#/components/schemas/CredentialVaultType"
+ "type": "string"
},
{
"type": "null"
}
],
- "description": "Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.",
- "examples": [
- "skyvern",
- "custom",
- "azure_vault",
- "bitwarden"
- ]
+ "title": "Next Block Label",
+ "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
},
- "proxy_location": {
+ "block_type": {
+ "type": "string",
+ "const": "code",
+ "title": "Block Type",
+ "default": "code"
+ },
+ "output_parameter": {
+ "$ref": "#/components/schemas/OutputParameter"
+ },
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
+ },
+ "model": {
"anyOf": [
- {
- "$ref": "#/components/schemas/ProxyLocation"
- },
- {
- "$ref": "#/components/schemas/GeoTarget"
- },
{
"additionalProperties": true,
"type": "object"
@@ -10861,40 +8826,108 @@
"type": "null"
}
],
- "title": "Proxy Location",
- "description": "Optional proxy location for this credential's pinned proxy identity."
+ "title": "Model"
},
- "proxy_session_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Proxy Session Id",
- "description": "Optional advanced reuse key for this credential's pinned proxy identity."
+ "disable_cache": {
+ "type": "boolean",
+ "title": "Disable Cache",
+ "default": false
},
- "rotate_proxy_session_id": {
+ "ignore_workflow_system_prompt": {
"type": "boolean",
- "title": "Rotate Proxy Session Id",
- "description": "Rotate the Skyvern-managed proxy sticky-session id when updating this credential.",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
+ },
+ "next_loop_on_failure": {
+ "type": "boolean",
+ "title": "Next Loop On Failure",
"default": false
+ },
+ "code": {
+ "type": "string",
+ "title": "Code"
+ },
+ "parameters": {
+ "items": {
+ "oneOf": [
+ {
+ "$ref": "#/components/schemas/WorkflowParameter"
+ },
+ {
+ "$ref": "#/components/schemas/ContextParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AWSSecretParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AzureSecretParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
+ },
+ {
+ "$ref": "#/components/schemas/OnePasswordCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AzureVaultCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/OutputParameter"
+ },
+ {
+ "$ref": "#/components/schemas/CredentialParameter"
+ }
+ ],
+ "discriminator": {
+ "propertyName": "parameter_type",
+ "mapping": {
+ "aws_secret": "#/components/schemas/AWSSecretParameter",
+ "azure_secret": "#/components/schemas/AzureSecretParameter",
+ "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
+ "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
+ "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
+ "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
+ "context": "#/components/schemas/ContextParameter",
+ "credential": "#/components/schemas/CredentialParameter",
+ "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
+ "output": "#/components/schemas/OutputParameter",
+ "workflow": "#/components/schemas/WorkflowParameter"
+ }
+ }
+ },
+ "type": "array",
+ "title": "Parameters",
+ "default": []
}
},
"type": "object",
"required": [
- "name",
- "credential_type",
- "credential"
+ "label",
+ "output_parameter",
+ "code"
],
- "title": "CreateCredentialRequest",
- "description": "Request model for creating a new credential."
+ "title": "CodeBlock"
},
- "CreateScriptRequest": {
+ "CodeBlockYAML": {
"properties": {
- "workflow_id": {
+ "block_type": {
+ "type": "string",
+ "const": "code",
+ "title": "Block Type",
+ "default": "code"
+ },
+ "label": {
+ "type": "string",
+ "title": "Label",
+ "description": "Author-facing identifier; must be unique per workflow."
+ },
+ "next_block_label": {
"anyOf": [
{
"type": "string"
@@ -10903,26 +8936,45 @@
"type": "null"
}
],
- "title": "Workflow Id",
- "description": "Associated workflow ID"
+ "title": "Next Block Label",
+ "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
},
- "run_id": {
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
+ },
+ "model": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Run Id",
- "description": "Associated run ID"
+ "title": "Model"
},
- "files": {
+ "ignore_workflow_system_prompt": {
+ "type": "boolean",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
+ },
+ "next_loop_on_failure": {
+ "type": "boolean",
+ "title": "Next Loop On Failure",
+ "default": false
+ },
+ "code": {
+ "type": "string",
+ "title": "Code"
+ },
+ "parameter_keys": {
"anyOf": [
{
"items": {
- "$ref": "#/components/schemas/ScriptFileCreate"
+ "type": "string"
},
"type": "array"
},
@@ -10930,46 +8982,24 @@
"type": "null"
}
],
- "title": "Files",
- "description": "Array of files to include in the script",
- "examples": [
- {
- "content": "cHJpbnQoIkhlbGxvLCBXb3JsZCEiKQ==",
- "encoding": "base64",
- "mime_type": "text/x-python",
- "path": "main.py"
- },
- {
- "content": "cmVxdWVzdHM9PTIuMjguMQ==",
- "encoding": "base64",
- "mime_type": "text/plain",
- "path": "requirements.txt"
- }
- ]
+ "title": "Parameter Keys"
}
},
"type": "object",
- "title": "CreateScriptRequest"
+ "required": [
+ "label",
+ "code"
+ ],
+ "title": "CodeBlockYAML"
},
- "CreateScriptResponse": {
+ "ConditionalBlock": {
"properties": {
- "script_id": {
+ "label": {
"type": "string",
- "title": "Script Id",
- "description": "Unique script identifier",
- "examples": [
- "s_abc123"
- ]
- },
- "version": {
- "type": "integer",
- "title": "Version",
- "description": "Script version number",
- "examples": [
- 1
- ]
+ "title": "Label",
+ "description": "Author-facing identifier for a block; unique within a workflow."
},
- "run_id": {
+ "next_block_label": {
"anyOf": [
{
"type": "string"
@@ -10978,140 +9008,139 @@
"type": "null"
}
],
- "title": "Run Id",
- "description": "ID of the workflow run or task run that generated this script"
- },
- "file_count": {
- "type": "integer",
- "title": "File Count",
- "description": "Total number of files in the script"
- },
- "file_tree": {
- "additionalProperties": {
- "$ref": "#/components/schemas/FileNode"
- },
- "type": "object",
- "title": "File Tree",
- "description": "Hierarchical file tree structure"
+ "title": "Next Block Label",
+ "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
},
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At",
- "description": "Timestamp when the script was created"
- }
- },
- "type": "object",
- "required": [
- "script_id",
- "version",
- "file_count",
- "file_tree",
- "created_at"
- ],
- "title": "CreateScriptResponse"
- },
- "CredentialParameter": {
- "properties": {
- "parameter_type": {
+ "block_type": {
"type": "string",
- "const": "credential",
- "title": "Parameter Type",
- "default": "credential"
+ "const": "conditional",
+ "title": "Block Type",
+ "default": "conditional"
},
- "key": {
- "type": "string",
- "title": "Key"
+ "output_parameter": {
+ "$ref": "#/components/schemas/OutputParameter"
},
- "description": {
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
+ },
+ "model": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Description"
+ "title": "Model"
},
- "credential_parameter_id": {
- "type": "string",
- "title": "Credential Parameter Id"
+ "disable_cache": {
+ "type": "boolean",
+ "title": "Disable Cache",
+ "default": false
},
- "workflow_id": {
+ "ignore_workflow_system_prompt": {
+ "type": "boolean",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
+ },
+ "next_loop_on_failure": {
+ "type": "boolean",
+ "title": "Next Loop On Failure",
+ "default": false
+ },
+ "branch_conditions": {
+ "items": {
+ "$ref": "#/components/schemas/BranchCondition"
+ },
+ "type": "array",
+ "title": "Branch Conditions"
+ }
+ },
+ "type": "object",
+ "required": [
+ "label",
+ "output_parameter"
+ ],
+ "title": "ConditionalBlock",
+ "description": "Branching block that selects the next block label based on list-ordered conditions."
+ },
+ "ConditionalBlockYAML": {
+ "properties": {
+ "block_type": {
"type": "string",
- "title": "Workflow Id"
+ "const": "conditional",
+ "title": "Block Type",
+ "default": "conditional"
},
- "credential_id": {
+ "label": {
"type": "string",
- "title": "Credential Id"
+ "title": "Label",
+ "description": "Author-facing identifier; must be unique per workflow."
},
- "credential_ids": {
+ "next_block_label": {
"anyOf": [
{
- "items": {
- "type": "string"
- },
- "type": "array"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Credential Ids"
+ "title": "Next Block Label",
+ "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
+ },
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
},
- "selection_strategy": {
+ "model": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Selection Strategy"
+ "title": "Model"
},
- "created_at": {
- "type": "string",
- "format": "date-time",
- "title": "Created At"
+ "ignore_workflow_system_prompt": {
+ "type": "boolean",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
},
- "modified_at": {
- "type": "string",
- "format": "date-time",
- "title": "Modified At"
+ "next_loop_on_failure": {
+ "type": "boolean",
+ "title": "Next Loop On Failure",
+ "default": false
},
- "deleted_at": {
- "anyOf": [
- {
- "type": "string",
- "format": "date-time"
- },
- {
- "type": "null"
- }
- ],
- "title": "Deleted At"
+ "branch_conditions": {
+ "items": {
+ "$ref": "#/components/schemas/BranchConditionYAML"
+ },
+ "type": "array",
+ "title": "Branch Conditions"
}
- },
- "type": "object",
- "required": [
- "key",
- "credential_parameter_id",
- "workflow_id",
- "credential_id",
- "created_at",
- "modified_at"
+ },
+ "type": "object",
+ "required": [
+ "label"
],
- "title": "CredentialParameter"
+ "title": "ConditionalBlockYAML"
},
- "CredentialParameterYAML": {
+ "ContextParameter": {
"properties": {
"parameter_type": {
"type": "string",
- "const": "credential",
+ "const": "context",
"title": "Parameter Type",
- "default": "credential"
+ "default": "context"
},
"key": {
"type": "string",
@@ -11128,92 +9157,93 @@
],
"title": "Description"
},
- "credential_id": {
- "type": "string",
- "title": "Credential Id"
- },
- "credential_ids": {
+ "source": {
"anyOf": [
{
- "items": {
- "type": "string"
- },
- "type": "array"
+ "$ref": "#/components/schemas/WorkflowParameter"
},
{
- "type": "null"
+ "$ref": "#/components/schemas/ContextParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AWSSecretParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AzureSecretParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
+ },
+ {
+ "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
+ },
+ {
+ "$ref": "#/components/schemas/OnePasswordCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/AzureVaultCredentialParameter"
+ },
+ {
+ "$ref": "#/components/schemas/OutputParameter"
+ },
+ {
+ "$ref": "#/components/schemas/CredentialParameter"
}
],
- "title": "Credential Ids"
+ "title": "Source"
},
- "selection_strategy": {
+ "value": {
"anyOf": [
{
"type": "string"
},
+ {
+ "type": "integer"
+ },
+ {
+ "type": "number"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "additionalProperties": true,
+ "type": "object"
+ },
+ {
+ "items": {},
+ "type": "array"
+ },
{
"type": "null"
}
],
- "title": "Selection Strategy"
+ "title": "Value"
}
},
"type": "object",
"required": [
"key",
- "credential_id"
+ "source"
],
- "title": "CredentialParameterYAML"
+ "title": "ContextParameter"
},
- "CredentialResponse": {
+ "ContextParameterYAML": {
"properties": {
- "credential_id": {
+ "parameter_type": {
"type": "string",
- "title": "Credential Id",
- "description": "Unique identifier for the credential",
- "examples": [
- "cred_1234567890"
- ]
- },
- "credential": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/PasswordCredentialResponse"
- },
- {
- "$ref": "#/components/schemas/CreditCardCredentialResponse"
- },
- {
- "$ref": "#/components/schemas/SecretCredentialResponse"
- }
- ],
- "title": "Credential",
- "description": "The credential data"
- },
- "credential_type": {
- "$ref": "#/components/schemas/CredentialType-Output",
- "description": "Type of the credential"
+ "const": "context",
+ "title": "Parameter Type",
+ "default": "context"
},
- "name": {
+ "key": {
"type": "string",
- "title": "Name",
- "description": "Name of the credential",
- "examples": [
- "Amazon Login"
- ]
- },
- "vault_type": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/CredentialVaultType"
- },
- {
- "type": "null"
- }
- ],
- "description": "Which vault stores this credential (e.g., 'skyvern', 'bitwarden', 'azure_vault', 'custom')"
+ "title": "Key"
},
- "browser_profile_id": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -11222,22 +9252,29 @@
"type": "null"
}
],
- "title": "Browser Profile Id",
- "description": "Browser profile ID linked to this credential"
+ "title": "Description"
},
- "tested_url": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Tested Url",
- "description": "Login page URL used during the credential test"
+ "source_parameter_key": {
+ "type": "string",
+ "title": "Source Parameter Key"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "source_parameter_key"
+ ],
+ "title": "ContextParameterYAML"
+ },
+ "CreateBrowserProfileRequest": {
+ "properties": {
+ "name": {
+ "type": "string",
+ "minLength": 1,
+ "title": "Name",
+ "description": "Name for the browser profile"
},
- "user_context": {
+ "description": {
"anyOf": [
{
"type": "string"
@@ -11246,35 +9283,34 @@
"type": "null"
}
],
- "title": "User Context",
- "description": "User-provided context describing the login sequence (e.g., 'click SSO button first')"
+ "title": "Description",
+ "description": "Optional profile description"
},
- "save_browser_session_intent": {
+ "browser_session_id": {
"anyOf": [
{
- "type": "boolean"
+ "type": "string",
+ "minLength": 1
},
{
"type": "null"
}
],
- "title": "Save Browser Session Intent",
- "description": "Whether the user intends to save a browser session, regardless of test outcome"
+ "title": "Browser Session Id",
+ "description": "Persistent browser session to convert into a profile. Omit for a blank profile."
},
- "folder_id": {
+ "workflow_run_id": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "minLength": 1
},
{
"type": "null"
}
],
- "title": "Folder Id",
- "description": "ID of the credential folder this credential belongs to, if any",
- "examples": [
- "cfld_1234567890"
- ]
+ "title": "Workflow Run Id",
+ "description": "Workflow run whose persisted session should be captured. Omit for a blank profile."
},
"proxy_location": {
"anyOf": [
@@ -11293,7 +9329,7 @@
}
],
"title": "Proxy Location",
- "description": "Optional proxy location used for the credential's pinned proxy identity."
+ "description": "Optional proxy location for this profile's pinned proxy identity."
},
"proxy_session_id": {
"anyOf": [
@@ -11305,444 +9341,202 @@
}
],
"title": "Proxy Session Id",
- "description": "Opaque Skyvern-managed proxy sticky-session id."
+ "description": "Explicit sticky-session id for this profile's pinned proxy identity."
}
},
"type": "object",
"required": [
- "credential_id",
- "credential",
- "credential_type",
"name"
],
- "title": "CredentialResponse",
- "description": "Response model for credential operations."
- },
- "CredentialType-Output": {
- "type": "string",
- "enum": [
- "password",
- "credit_card",
- "secret"
- ],
- "title": "CredentialType",
- "description": "Type of credential stored in the system."
- },
- "CredentialVaultType": {
- "type": "string",
- "enum": [
- "skyvern",
- "bitwarden",
- "azure_vault",
- "gcp",
- "custom"
- ],
- "title": "CredentialVaultType"
+ "title": "CreateBrowserProfileRequest"
},
- "CreditCardBillingAddress": {
+ "CreateBrowserSessionRequest": {
"properties": {
- "line1": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Line1",
- "description": "Billing address line 1",
- "examples": [
- "123 Main St"
- ]
- },
- "line2": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Line2",
- "description": "Billing address line 2",
- "examples": [
- "Apt 4B"
- ]
- },
- "city": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "City",
- "description": "Billing city",
- "examples": [
- "San Francisco"
- ]
- },
- "state": {
+ "timeout": {
"anyOf": [
{
- "type": "string"
+ "type": "integer",
+ "maximum": 1440.0,
+ "minimum": 5.0
},
{
"type": "null"
}
],
- "title": "State",
- "description": "Billing state or region",
- "examples": [
- "California"
- ]
+ "title": "Timeout",
+ "description": "Timeout in minutes for the session. Timeout is applied after the session is started. Must be between 5 and 1440. Defaults to 60.",
+ "default": 60
},
- "state_code": {
+ "proxy_location": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/ProxyLocation"
+ },
+ {
+ "$ref": "#/components/schemas/GeoTarget"
+ },
+ {
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "State Code",
- "description": "Billing state or region code",
- "examples": [
- "CA"
- ]
+ "title": "Proxy Location",
+ "description": "\nGeographic Proxy location to route the browser traffic through. This is only available in Skyvern Cloud.\n\nAvailable geotargeting options:\n- RESIDENTIAL: the default value. Skyvern Cloud uses a random US residential proxy.\n- RESIDENTIAL_ES: Spain\n- RESIDENTIAL_IE: Ireland\n- RESIDENTIAL_GB: United Kingdom\n- RESIDENTIAL_IN: India\n- RESIDENTIAL_JP: Japan\n- RESIDENTIAL_FR: France\n- RESIDENTIAL_DE: Germany\n- RESIDENTIAL_NZ: New Zealand\n- RESIDENTIAL_PH: Philippines\n- RESIDENTIAL_KR: South Korea\n- RESIDENTIAL_SA: Saudi Arabia\n- RESIDENTIAL_ZA: South Africa\n- RESIDENTIAL_AR: Argentina\n- RESIDENTIAL_AU: Australia\n- RESIDENTIAL_BR: Brazil\n- RESIDENTIAL_TR: Turkey\n- RESIDENTIAL_CA: Canada\n- RESIDENTIAL_MX: Mexico\n- RESIDENTIAL_IT: Italy\n- RESIDENTIAL_NL: Netherlands\n- RESIDENTIAL_ISP: ISP proxy\n- US-CA: California (deprecated, routes through RESIDENTIAL_ISP)\n- US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)\n- US-TX: Texas (deprecated, routes through RESIDENTIAL_ISP)\n- US-FL: Florida (deprecated, routes through RESIDENTIAL_ISP)\n- US-WA: Washington (deprecated, routes through RESIDENTIAL_ISP)\n- NONE: No proxy\n\nFor self-hosted deployments, you can pass a custom proxy URL as a dict: {\"url\": \"http://user:[email protected]:8080\"}. This routes the browser through your own proxy server and takes precedence over any globally configured proxy pool.\n Can also be a GeoTarget object for granular city/state targeting: {\"country\": \"US\", \"subdivision\": \"CA\", \"city\": \"San Francisco\"}, or a custom proxy URL dict for self-hosted deployments: {\"url\": \"http://user:[email protected]:8080\"}"
},
- "postal_code": {
+ "extensions": {
"anyOf": [
{
- "type": "string"
+ "items": {
+ "$ref": "#/components/schemas/Extensions"
+ },
+ "type": "array"
},
{
"type": "null"
}
],
- "title": "Postal Code",
- "description": "Billing postal code",
- "examples": [
- "94105"
- ]
+ "title": "Extensions",
+ "description": "A list of extensions to install in the browser session."
},
- "country": {
+ "browser_type": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/PersistentBrowserType"
},
{
"type": "null"
}
],
- "title": "Country",
- "description": "Billing country",
- "examples": [
- "United States"
- ]
+ "description": "The type of browser to use for the session."
},
- "country_code": {
+ "browser_profile_id": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "pattern": "^bp_"
},
{
"type": "null"
}
],
- "title": "Country Code",
- "description": "ISO 3166-1 alpha-2 billing country code",
- "examples": [
- "US"
- ]
- }
- },
- "type": "object",
- "title": "CreditCardBillingAddress",
- "description": "Optional billing address fields associated with a credit card credential."
- },
- "CreditCardCredentialResponse": {
- "properties": {
- "last_four": {
- "type": "string",
- "title": "Last Four",
- "description": "Last four digits of the credit card number",
- "examples": [
- "1234"
- ]
- },
- "brand": {
- "type": "string",
- "title": "Brand",
- "description": "Brand of the credit card",
- "examples": [
- "visa"
- ]
- }
- },
- "type": "object",
- "required": [
- "last_four",
- "brand"
- ],
- "title": "CreditCardCredentialResponse",
- "description": "Response model for credit card credentials — non-sensitive fields only.\n\nSECURITY: Must NEVER include full card number, CVV, expiration date, card holder name,\nbilling fields, or metadata."
- },
- "CustomLLM": {
- "properties": {
- "id": {
- "type": "string",
- "title": "Id"
- },
- "organization_id": {
- "type": "string",
- "title": "Organization Id"
- },
- "config": {
- "$ref": "#/components/schemas/CustomLLMConfig"
- },
- "created_at": {
- "type": "string",
- "title": "Created At"
- },
- "modified_at": {
- "type": "string",
- "title": "Modified At"
+ "title": "Browser Profile Id",
+ "description": "ID of a browser profile to load into this session (restores cookies, localStorage, etc.). browser_profile_id starts with `bp_`."
},
- "valid": {
+ "generate_browser_profile": {
"type": "boolean",
- "title": "Valid"
+ "title": "Generate Browser Profile",
+ "description": "When true, the session's browser profile (cookies, localStorage, etc.) is saved to storage when the session ends so it can be turned into a reusable browser profile. Defaults to false to avoid storing profiles for sessions that never need them. Sessions started with a browser_profile_id always persist their profile regardless of this flag.",
+ "default": false
}
},
"type": "object",
- "required": [
- "id",
- "organization_id",
- "config",
- "created_at",
- "modified_at",
- "valid"
- ],
- "title": "CustomLLM"
+ "title": "CreateBrowserSessionRequest"
},
- "CustomLLMConfig": {
+ "CreateCredentialRequest": {
"properties": {
- "display_name": {
+ "name": {
"type": "string",
- "maxLength": 120,
- "minLength": 1,
- "title": "Display Name"
- },
- "provider": {
- "$ref": "#/components/schemas/CustomLLMProvider"
+ "title": "Name",
+ "description": "Name of the credential",
+ "examples": [
+ "Amazon Login"
+ ]
},
- "model_name": {
- "type": "string",
- "maxLength": 250,
- "minLength": 1,
- "title": "Model Name"
+ "credential_type": {
+ "$ref": "#/components/schemas/skyvern__forge__sdk__schemas__credentials__CredentialType",
+ "description": "Type of credential to create"
},
- "api_base": {
+ "credential": {
"anyOf": [
{
- "type": "string",
- "maxLength": 500
+ "$ref": "#/components/schemas/NonEmptyPasswordCredential"
},
{
- "type": "null"
- }
- ],
- "title": "Api Base"
- },
- "api_key": {
- "anyOf": [
- {
- "type": "string",
- "maxLength": 1000
+ "$ref": "#/components/schemas/NonEmptyCreditCardCredential"
},
{
- "type": "null"
+ "$ref": "#/components/schemas/SecretCredential"
}
],
- "title": "Api Key"
+ "title": "Credential",
+ "description": "The credential data to store",
+ "examples": [
+ {
+ "password": "securepassword123",
+ "username": "[email protected]"
+ }
+ ]
},
- "api_version": {
+ "vault_type": {
"anyOf": [
{
- "type": "string",
- "maxLength": 100
+ "$ref": "#/components/schemas/CredentialVaultType"
},
{
"type": "null"
}
],
- "title": "Api Version"
- },
- "supports_vision": {
- "type": "boolean",
- "title": "Supports Vision",
- "default": true
- },
- "add_assistant_prefix": {
- "type": "boolean",
- "title": "Add Assistant Prefix",
- "default": false
+ "description": "Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.",
+ "examples": [
+ "skyvern",
+ "custom",
+ "azure_vault",
+ "bitwarden"
+ ]
},
- "max_completion_tokens": {
+ "proxy_location": {
"anyOf": [
{
- "type": "integer",
- "maximum": 1000000,
- "minimum": 1
+ "$ref": "#/components/schemas/ProxyLocation"
},
{
- "type": "null"
- }
- ],
- "title": "Max Completion Tokens"
- },
- "temperature": {
- "anyOf": [
+ "$ref": "#/components/schemas/GeoTarget"
+ },
{
- "type": "number",
- "maximum": 2,
- "minimum": 0
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Temperature"
+ "title": "Proxy Location",
+ "description": "Optional proxy location for this credential's pinned proxy identity."
},
- "reasoning_effort": {
+ "proxy_session_id": {
"anyOf": [
{
- "type": "string",
- "maxLength": 50
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Reasoning Effort"
- }
- },
- "type": "object",
- "required": [
- "display_name",
- "provider",
- "model_name"
- ],
- "title": "CustomLLMConfig"
- },
- "CustomLLMCreateRequest": {
- "properties": {
- "config": {
- "$ref": "#/components/schemas/CustomLLMConfig"
- }
- },
- "type": "object",
- "required": [
- "config"
- ],
- "title": "CustomLLMCreateRequest"
- },
- "CustomLLMListResponse": {
- "properties": {
- "custom_llms": {
- "items": {
- "$ref": "#/components/schemas/CustomLLM"
- },
- "type": "array",
- "title": "Custom Llms"
- }
- },
- "type": "object",
- "required": [
- "custom_llms"
- ],
- "title": "CustomLLMListResponse"
- },
- "CustomLLMProvider": {
- "type": "string",
- "enum": [
- "openai_compatible",
- "ollama",
- "openrouter"
- ],
- "title": "CustomLLMProvider"
- },
- "CustomLLMResponse": {
- "properties": {
- "custom_llm": {
- "$ref": "#/components/schemas/CustomLLM"
- }
- },
- "type": "object",
- "required": [
- "custom_llm"
- ],
- "title": "CustomLLMResponse"
- },
- "CustomLLMUpdateRequest": {
- "properties": {
- "config": {
- "$ref": "#/components/schemas/CustomLLMConfig"
- }
- },
- "type": "object",
- "required": [
- "config"
- ],
- "title": "CustomLLMUpdateRequest"
- },
- "DeleteScheduleResponse": {
- "properties": {
- "ok": {
+ "title": "Proxy Session Id",
+ "description": "Optional advanced reuse key for this credential's pinned proxy identity."
+ },
+ "rotate_proxy_session_id": {
"type": "boolean",
- "title": "Ok"
- }
- },
- "type": "object",
- "required": [
- "ok"
- ],
- "title": "DeleteScheduleResponse"
- },
- "DeployScriptRequest": {
- "properties": {
- "files": {
- "items": {
- "$ref": "#/components/schemas/ScriptFileCreate"
- },
- "type": "array",
- "title": "Files",
- "description": "Array of files to include in the script",
- "examples": [
- {
- "content": "cHJpbnQoIkhlbGxvLCBXb3JsZCEiKQ==",
- "encoding": "base64",
- "mime_type": "text/x-python",
- "path": "src/main.py"
- }
- ]
+ "title": "Rotate Proxy Session Id",
+ "description": "Rotate the Skyvern-managed proxy sticky-session id when updating this credential.",
+ "default": false
}
},
"type": "object",
"required": [
- "files"
+ "name",
+ "credential_type",
+ "credential"
],
- "title": "DeployScriptRequest",
- "description": "Request model for deploying a script with updated files."
+ "title": "CreateCredentialRequest",
+ "description": "Request model for creating a new credential."
},
- "DownloadFilesRequest": {
+ "CreateScriptRequest": {
"properties": {
- "url": {
+ "workflow_id": {
"anyOf": [
{
"type": "string"
@@ -11751,10 +9545,10 @@
"type": "null"
}
],
- "title": "Url",
- "description": "Website URL"
+ "title": "Workflow Id",
+ "description": "Associated workflow ID"
},
- "webhook_url": {
+ "run_id": {
"anyOf": [
{
"type": "string"
@@ -11763,21 +9557,61 @@
"type": "null"
}
],
- "title": "Webhook Url",
- "description": "Webhook URL to send status updates"
+ "title": "Run Id",
+ "description": "Associated run ID"
},
- "proxy_location": {
+ "files": {
"anyOf": [
{
- "$ref": "#/components/schemas/ProxyLocation"
+ "items": {
+ "$ref": "#/components/schemas/ScriptFileCreate"
+ },
+ "type": "array"
},
{
"type": "null"
}
],
- "description": "Proxy location to use"
+ "title": "Files",
+ "description": "Array of files to include in the script",
+ "examples": [
+ {
+ "content": "cHJpbnQoIkhlbGxvLCBXb3JsZCEiKQ==",
+ "encoding": "base64",
+ "mime_type": "text/x-python",
+ "path": "main.py"
+ },
+ {
+ "content": "cmVxdWVzdHM9PTIuMjguMQ==",
+ "encoding": "base64",
+ "mime_type": "text/plain",
+ "path": "requirements.txt"
+ }
+ ]
+ }
+ },
+ "type": "object",
+ "title": "CreateScriptRequest"
+ },
+ "CreateScriptResponse": {
+ "properties": {
+ "script_id": {
+ "type": "string",
+ "title": "Script Id",
+ "description": "Unique script identifier",
+ "examples": [
+ "s_abc123"
+ ]
},
- "totp_identifier": {
+ "version": {
+ "type": "integer",
+ "title": "Version",
+ "description": "Script version number",
+ "examples": [
+ 1
+ ]
+ },
+ "run_id": {
"anyOf": [
{
"type": "string"
@@ -11786,10 +9620,52 @@
"type": "null"
}
],
- "title": "Totp Identifier",
- "description": "Identifier for TOTP (Time-based One-Time Password) if required"
+ "title": "Run Id",
+ "description": "ID of the workflow run or task run that generated this script"
},
- "totp_url": {
+ "file_count": {
+ "type": "integer",
+ "title": "File Count",
+ "description": "Total number of files in the script"
+ },
+ "file_tree": {
+ "additionalProperties": {
+ "$ref": "#/components/schemas/FileNode"
+ },
+ "type": "object",
+ "title": "File Tree",
+ "description": "Hierarchical file tree structure"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At",
+ "description": "Timestamp when the script was created"
+ }
+ },
+ "type": "object",
+ "required": [
+ "script_id",
+ "version",
+ "file_count",
+ "file_tree",
+ "created_at"
+ ],
+ "title": "CreateScriptResponse"
+ },
+ "CredentialParameter": {
+ "properties": {
+ "parameter_type": {
+ "type": "string",
+ "const": "credential",
+ "title": "Parameter Type",
+ "default": "credential"
+ },
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
"type": "string"
@@ -11798,25 +9674,67 @@
"type": "null"
}
],
- "title": "Totp Url",
- "description": "TOTP URL to fetch one-time passwords"
+ "title": "Description"
},
- "browser_session_id": {
+ "credential_parameter_id": {
+ "type": "string",
+ "title": "Credential Parameter Id"
+ },
+ "workflow_id": {
+ "type": "string",
+ "title": "Workflow Id"
+ },
+ "credential_id": {
+ "type": "string",
+ "title": "Credential Id"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Created At"
+ },
+ "modified_at": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Modified At"
+ },
+ "deleted_at": {
"anyOf": [
{
- "type": "string"
+ "type": "string",
+ "format": "date-time"
},
{
"type": "null"
}
],
- "title": "Browser Session Id",
- "description": "ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`",
- "examples": [
- "pbs_123456"
- ]
+ "title": "Deleted At"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "credential_parameter_id",
+ "workflow_id",
+ "credential_id",
+ "created_at",
+ "modified_at"
+ ],
+ "title": "CredentialParameter"
+ },
+ "CredentialParameterYAML": {
+ "properties": {
+ "parameter_type": {
+ "type": "string",
+ "const": "credential",
+ "title": "Parameter Type",
+ "default": "credential"
},
- "browser_profile_id": {
+ "key": {
+ "type": "string",
+ "title": "Key"
+ },
+ "description": {
"anyOf": [
{
"type": "string"
@@ -11825,73 +9743,93 @@
"type": "null"
}
],
- "title": "Browser Profile Id",
- "description": "ID of a browser profile to reuse for this run"
+ "title": "Description"
},
- "browser_address": {
+ "credential_id": {
+ "type": "string",
+ "title": "Credential Id"
+ }
+ },
+ "type": "object",
+ "required": [
+ "key",
+ "credential_id"
+ ],
+ "title": "CredentialParameterYAML"
+ },
+ "CredentialResponse": {
+ "properties": {
+ "credential_id": {
+ "type": "string",
+ "title": "Credential Id",
+ "description": "Unique identifier for the credential",
+ "examples": [
+ "cred_1234567890"
+ ]
+ },
+ "credential": {
"anyOf": [
{
- "type": "string"
+ "$ref": "#/components/schemas/PasswordCredentialResponse"
},
{
- "type": "null"
+ "$ref": "#/components/schemas/CreditCardCredentialResponse"
+ },
+ {
+ "$ref": "#/components/schemas/SecretCredentialResponse"
}
],
- "title": "Browser Address",
- "description": "The CDP address for the task.",
+ "title": "Credential",
+ "description": "The credential data"
+ },
+ "credential_type": {
+ "$ref": "#/components/schemas/CredentialType-Output",
+ "description": "Type of the credential"
+ },
+ "name": {
+ "type": "string",
+ "title": "Name",
+ "description": "Name of the credential",
"examples": [
- "http://127.0.0.1:9222",
- "ws://127.0.0.1:9222/devtools/browser/1234567890"
+ "Amazon Login"
]
},
- "extra_http_headers": {
+ "vault_type": {
"anyOf": [
{
- "additionalProperties": {
- "type": "string"
- },
- "type": "object"
+ "$ref": "#/components/schemas/CredentialVaultType"
},
{
"type": "null"
}
],
- "title": "Extra Http Headers",
- "description": "Additional HTTP headers to include in requests"
+ "description": "Which vault stores this credential (e.g., 'skyvern', 'bitwarden', 'azure_vault', 'custom')"
},
- "cdp_connect_headers": {
+ "browser_profile_id": {
"anyOf": [
{
- "additionalProperties": {
- "type": "string"
- },
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Cdp Connect Headers",
- "description": "HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites."
+ "title": "Browser Profile Id",
+ "description": "Browser profile ID linked to this credential"
},
- "max_screenshot_scrolling_times": {
+ "tested_url": {
"anyOf": [
{
- "type": "integer"
+ "type": "string"
},
{
"type": "null"
- }
- ],
- "title": "Max Screenshot Scrolling Times",
- "description": "Maximum number of times to scroll for screenshots"
- },
- "navigation_goal": {
- "type": "string",
- "title": "Navigation Goal",
- "description": "Instructions for navigating to and downloading the file"
+ }
+ ],
+ "title": "Tested Url",
+ "description": "Login page URL used during the credential test"
},
- "download_suffix": {
+ "user_context": {
"anyOf": [
{
"type": "string"
@@ -11900,48 +9838,137 @@
"type": "null"
}
],
- "title": "Download Suffix",
- "description": "Suffix or complete filename for the downloaded file"
+ "title": "User Context",
+ "description": "User-provided context describing the login sequence (e.g., 'click SSO button first')"
},
- "download_timeout": {
+ "save_browser_session_intent": {
"anyOf": [
{
- "type": "number"
+ "type": "boolean"
},
{
"type": "null"
}
],
- "title": "Download Timeout",
- "description": "Timeout in seconds for the download operation"
+ "title": "Save Browser Session Intent",
+ "description": "Whether the user intends to save a browser session, regardless of test outcome"
},
- "max_steps_per_run": {
+ "folder_id": {
"anyOf": [
{
- "type": "integer"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Max Steps Per Run",
- "description": "Maximum number of steps to execute"
+ "title": "Folder Id",
+ "description": "ID of the credential folder this credential belongs to, if any",
+ "examples": [
+ "cfld_1234567890"
+ ]
}
},
"type": "object",
"required": [
- "navigation_goal"
+ "credential_id",
+ "credential",
+ "credential_type",
+ "name"
],
- "title": "DownloadFilesRequest"
+ "title": "CredentialResponse",
+ "description": "Response model for credential operations."
},
- "DownloadToS3Block": {
+ "CredentialType-Output": {
+ "type": "string",
+ "enum": [
+ "password",
+ "credit_card",
+ "secret"
+ ],
+ "title": "CredentialType",
+ "description": "Type of credential stored in the system."
+ },
+ "CredentialVaultType": {
+ "type": "string",
+ "enum": [
+ "skyvern",
+ "bitwarden",
+ "azure_vault",
+ "gcp",
+ "custom"
+ ],
+ "title": "CredentialVaultType"
+ },
+ "CreditCardCredentialResponse": {
"properties": {
- "label": {
+ "last_four": {
"type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
+ "title": "Last Four",
+ "description": "Last four digits of the credit card number",
+ "examples": [
+ "1234"
+ ]
},
- "next_block_label": {
+ "brand": {
+ "type": "string",
+ "title": "Brand",
+ "description": "Brand of the credit card",
+ "examples": [
+ "visa"
+ ]
+ }
+ },
+ "type": "object",
+ "required": [
+ "last_four",
+ "brand"
+ ],
+ "title": "CreditCardCredentialResponse",
+ "description": "Response model for credit card credentials — non-sensitive fields only.\n\nSECURITY: Must NEVER include full card number, CVV, expiration date, or card holder name."
+ },
+ "DeleteScheduleResponse": {
+ "properties": {
+ "ok": {
+ "type": "boolean",
+ "title": "Ok"
+ }
+ },
+ "type": "object",
+ "required": [
+ "ok"
+ ],
+ "title": "DeleteScheduleResponse"
+ },
+ "DeployScriptRequest": {
+ "properties": {
+ "files": {
+ "items": {
+ "$ref": "#/components/schemas/ScriptFileCreate"
+ },
+ "type": "array",
+ "title": "Files",
+ "description": "Array of files to include in the script",
+ "examples": [
+ {
+ "content": "cHJpbnQoIkhlbGxvLCBXb3JsZCEiKQ==",
+ "encoding": "base64",
+ "mime_type": "text/x-python",
+ "path": "src/main.py"
+ }
+ ]
+ }
+ },
+ "type": "object",
+ "required": [
+ "files"
+ ],
+ "title": "DeployScriptRequest",
+ "description": "Request model for deploying a script with updated files."
+ },
+ "DownloadFilesRequest": {
+ "properties": {
+ "url": {
"anyOf": [
{
"type": "string"
@@ -11950,77 +9977,33 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
- },
- "block_type": {
- "type": "string",
- "const": "download_to_s3",
- "title": "Block Type",
- "default": "download_to_s3"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "title": "Url",
+ "description": "Website URL"
},
- "model": {
+ "webhook_url": {
"anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Model"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "url": {
- "type": "string",
- "title": "Url"
- }
- },
- "type": "object",
- "required": [
- "label",
- "output_parameter",
- "url"
- ],
- "title": "DownloadToS3Block"
- },
- "DownloadToS3BlockYAML": {
- "properties": {
- "block_type": {
- "type": "string",
- "const": "download_to_s3",
- "title": "Block Type",
- "default": "download_to_s3"
+ "title": "Webhook Url",
+ "description": "Webhook URL to send status updates"
},
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
+ "proxy_location": {
+ "anyOf": [
+ {
+ "$ref": "#/components/schemas/ProxyLocation"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Proxy location to use"
},
- "next_block_label": {
+ "totp_identifier": {
"anyOf": [
{
"type": "string"
@@ -12029,56 +10012,37 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "title": "Totp Identifier",
+ "description": "Identifier for TOTP (Time-based One-Time Password) if required"
},
- "model": {
+ "totp_url": {
"anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Model"
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
+ "title": "Totp Url",
+ "description": "TOTP URL to fetch one-time passwords"
},
- "url": {
- "type": "string",
- "title": "Url"
- }
- },
- "type": "object",
- "required": [
- "label",
- "url"
- ],
- "title": "DownloadToS3BlockYAML"
- },
- "EmailInboxBlock": {
- "properties": {
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
+ "browser_session_id": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "title": "Browser Session Id",
+ "description": "ID of the browser session to use, which is prefixed by `pbs_` e.g. `pbs_123456`",
+ "examples": [
+ "pbs_123456"
+ ]
},
- "next_block_label": {
+ "browser_profile_id": {
"anyOf": [
{
"type": "string"
@@ -12087,92 +10051,73 @@
"type": "null"
}
],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
- },
- "block_type": {
- "type": "string",
- "const": "email_inbox",
- "title": "Block Type",
- "default": "email_inbox"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
+ "title": "Browser Profile Id",
+ "description": "ID of a browser profile to reuse for this run"
},
- "model": {
+ "browser_address": {
"anyOf": [
{
- "additionalProperties": true,
- "type": "object"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Model"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "email_client": {
- "type": "string",
- "enum": [
- "gmail",
- "outlook"
- ],
- "title": "Email Client"
+ "title": "Browser Address",
+ "description": "The CDP address for the task.",
+ "examples": [
+ "http://127.0.0.1:9222",
+ "ws://127.0.0.1:9222/devtools/browser/1234567890"
+ ]
},
- "credential_id": {
+ "extra_http_headers": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Credential Id"
+ "title": "Extra Http Headers",
+ "description": "Additional HTTP headers to include in requests"
},
- "folder": {
+ "cdp_connect_headers": {
"anyOf": [
{
- "type": "string"
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Folder"
+ "title": "Cdp Connect Headers",
+ "description": "HTTP headers attached ONLY to the CDP WebSocket handshake when connecting to a remote browser via browser_address. Never forwarded to target websites."
},
- "prompt": {
+ "max_screenshot_scrolling_times": {
"anyOf": [
{
- "type": "string"
+ "type": "integer"
},
{
"type": "null"
}
],
- "title": "Prompt"
+ "title": "Max Screenshot Scrolling Times",
+ "description": "Maximum number of times to scroll for screenshots"
},
- "sender": {
+ "navigation_goal": {
+ "type": "string",
+ "title": "Navigation Goal",
+ "description": "Instructions for navigating to and downloading the file"
+ },
+ "download_suffix": {
"anyOf": [
{
"type": "string"
@@ -12181,20 +10126,22 @@
"type": "null"
}
],
- "title": "Sender"
+ "title": "Download Suffix",
+ "description": "Suffix or complete filename for the downloaded file"
},
- "subject": {
+ "download_timeout": {
"anyOf": [
{
- "type": "string"
+ "type": "number"
},
{
"type": "null"
}
],
- "title": "Subject"
+ "title": "Download Timeout",
+ "description": "Timeout in seconds for the download operation"
},
- "newer_than_days": {
+ "max_steps_per_run": {
"anyOf": [
{
"type": "integer"
@@ -12203,97 +10150,22 @@
"type": "null"
}
],
- "title": "Newer Than Days"
- },
- "max_results": {
- "type": "integer",
- "title": "Max Results",
- "default": 25
- },
- "include_body": {
- "type": "boolean",
- "title": "Include Body",
- "default": true
- },
- "parameters": {
- "items": {
- "oneOf": [
- {
- "$ref": "#/components/schemas/WorkflowParameter"
- },
- {
- "$ref": "#/components/schemas/ContextParameter"
- },
- {
- "$ref": "#/components/schemas/AWSSecretParameter"
- },
- {
- "$ref": "#/components/schemas/AzureSecretParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
- },
- {
- "$ref": "#/components/schemas/OnePasswordCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/AzureVaultCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/OutputParameter"
- },
- {
- "$ref": "#/components/schemas/CredentialParameter"
- }
- ],
- "discriminator": {
- "propertyName": "parameter_type",
- "mapping": {
- "aws_secret": "#/components/schemas/AWSSecretParameter",
- "azure_secret": "#/components/schemas/AzureSecretParameter",
- "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
- "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
- "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
- "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
- "context": "#/components/schemas/ContextParameter",
- "credential": "#/components/schemas/CredentialParameter",
- "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
- "output": "#/components/schemas/OutputParameter",
- "workflow": "#/components/schemas/WorkflowParameter"
- }
- }
- },
- "type": "array",
- "title": "Parameters",
- "default": []
+ "title": "Max Steps Per Run",
+ "description": "Maximum number of steps to execute"
}
},
"type": "object",
"required": [
- "label",
- "output_parameter",
- "email_client"
+ "navigation_goal"
],
- "title": "EmailInboxBlock"
+ "title": "DownloadFilesRequest"
},
- "EmailInboxBlockYAML": {
+ "DownloadToS3Block": {
"properties": {
- "block_type": {
- "type": "string",
- "const": "email_inbox",
- "title": "Block Type",
- "default": "email_inbox"
- },
"label": {
"type": "string",
"title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
+ "description": "Author-facing identifier for a block; unique within a workflow."
},
"next_block_label": {
"anyOf": [
@@ -12305,7 +10177,16 @@
}
],
"title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
+ "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
+ },
+ "block_type": {
+ "type": "string",
+ "const": "download_to_s3",
+ "title": "Block Type",
+ "default": "download_to_s3"
+ },
+ "output_parameter": {
+ "$ref": "#/components/schemas/OutputParameter"
},
"continue_on_failure": {
"type": "boolean",
@@ -12324,6 +10205,11 @@
],
"title": "Model"
},
+ "disable_cache": {
+ "type": "boolean",
+ "title": "Disable Cache",
+ "default": false
+ },
"ignore_workflow_system_prompt": {
"type": "boolean",
"title": "Ignore Workflow System Prompt",
@@ -12334,59 +10220,33 @@
"title": "Next Loop On Failure",
"default": false
},
- "email_client": {
+ "url": {
"type": "string",
- "enum": [
- "gmail",
- "outlook"
- ],
- "title": "Email Client"
- },
- "credential_id": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Credential Id"
- },
- "folder": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Folder"
- },
- "prompt": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Prompt"
- },
- "sender": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sender"
+ "title": "Url"
+ }
+ },
+ "type": "object",
+ "required": [
+ "label",
+ "output_parameter",
+ "url"
+ ],
+ "title": "DownloadToS3Block"
+ },
+ "DownloadToS3BlockYAML": {
+ "properties": {
+ "block_type": {
+ "type": "string",
+ "const": "download_to_s3",
+ "title": "Block Type",
+ "default": "download_to_s3"
},
- "subject": {
+ "label": {
+ "type": "string",
+ "title": "Label",
+ "description": "Author-facing identifier; must be unique per workflow."
+ },
+ "next_block_label": {
"anyOf": [
{
"type": "string"
@@ -12395,50 +10255,47 @@
"type": "null"
}
],
- "title": "Subject"
+ "title": "Next Block Label",
+ "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
+ },
+ "continue_on_failure": {
+ "type": "boolean",
+ "title": "Continue On Failure",
+ "default": false
},
- "newer_than_days": {
+ "model": {
"anyOf": [
{
- "type": "integer"
+ "additionalProperties": true,
+ "type": "object"
},
{
"type": "null"
}
],
- "title": "Newer Than Days"
+ "title": "Model"
},
- "max_results": {
- "type": "integer",
- "title": "Max Results",
- "default": 25
+ "ignore_workflow_system_prompt": {
+ "type": "boolean",
+ "title": "Ignore Workflow System Prompt",
+ "default": false
},
- "include_body": {
+ "next_loop_on_failure": {
"type": "boolean",
- "title": "Include Body",
- "default": true
+ "title": "Next Loop On Failure",
+ "default": false
},
- "parameter_keys": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Parameter Keys"
+ "url": {
+ "type": "string",
+ "title": "Url"
}
},
"type": "object",
"required": [
"label",
- "email_client"
+ "url"
],
- "title": "EmailInboxBlockYAML"
+ "title": "DownloadToS3BlockYAML"
},
"Extensions": {
"type": "string",
@@ -13787,8 +11644,7 @@
"enum": [
"s3",
"azure",
- "google_drive",
- "sftp"
+ "google_drive"
],
"title": "FileStorageType"
},
@@ -13800,8 +11656,7 @@
"excel",
"pdf",
"image",
- "docx",
- "zip"
+ "docx"
],
"title": "FileType"
},
@@ -13968,106 +11823,6 @@
],
"title": "Google Drive Folder Id"
},
- "sftp_host": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Host"
- },
- "sftp_port": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Port"
- },
- "sftp_username": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Username"
- },
- "sftp_password": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Password"
- },
- "sftp_private_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Private Key"
- },
- "sftp_private_key_passphrase": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Private Key Passphrase"
- },
- "sftp_remote_path": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Remote Path"
- },
- "sftp_host_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Host Key"
- },
- "prompt": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Prompt",
- "description": "Optional natural-language control over which downloaded files are uploaded; empty means upload all."
- },
"path": {
"anyOf": [
{
@@ -14078,12 +11833,6 @@
}
],
"title": "Path"
- },
- "continue_on_empty": {
- "type": "boolean",
- "title": "Continue On Empty",
- "description": "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.",
- "default": false
}
},
"type": "object",
@@ -14259,106 +12008,6 @@
],
"title": "Google Drive Folder Id"
},
- "sftp_host": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Host"
- },
- "sftp_port": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Port"
- },
- "sftp_username": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Username"
- },
- "sftp_password": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Password"
- },
- "sftp_private_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Private Key"
- },
- "sftp_private_key_passphrase": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Private Key Passphrase"
- },
- "sftp_remote_path": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Remote Path"
- },
- "sftp_host_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Sftp Host Key"
- },
- "prompt": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Prompt",
- "description": "Optional natural-language control over which downloaded files are uploaded; empty means upload all."
- },
"path": {
"anyOf": [
{
@@ -14637,17 +12286,8 @@
{
"$ref": "#/components/schemas/GoogleSheetsReadBlock"
},
- {
- "$ref": "#/components/schemas/EmailInboxBlock"
- },
{
"$ref": "#/components/schemas/GoogleSheetsWriteBlock"
- },
- {
- "$ref": "#/components/schemas/PdfFillBlock"
- },
- {
- "$ref": "#/components/schemas/SplitPdfBlock"
}
],
"discriminator": {
@@ -14657,7 +12297,6 @@
"code": "#/components/schemas/CodeBlock",
"conditional": "#/components/schemas/ConditionalBlock",
"download_to_s3": "#/components/schemas/DownloadToS3Block",
- "email_inbox": "#/components/schemas/EmailInboxBlock",
"extraction": "#/components/schemas/ExtractionBlock",
"file_download": "#/components/schemas/FileDownloadBlock",
"file_upload": "#/components/schemas/FileUploadBlock",
@@ -14670,11 +12309,9 @@
"human_interaction": "#/components/schemas/HumanInteractionBlock",
"login": "#/components/schemas/LoginBlock",
"navigation": "#/components/schemas/NavigationBlock",
- "pdf_fill": "#/components/schemas/PdfFillBlock",
"pdf_parser": "#/components/schemas/PDFParserBlock",
"print_page": "#/components/schemas/PrintPageBlock",
"send_email": "#/components/schemas/SendEmailBlock",
- "split_pdf": "#/components/schemas/SplitPdfBlock",
"task": "#/components/schemas/TaskBlock",
"task_v2": "#/components/schemas/TaskV2Block",
"text_prompt": "#/components/schemas/TextPromptBlock",
@@ -14917,21 +12554,12 @@
{
"$ref": "#/components/schemas/PrintPageBlockYAML"
},
- {
- "$ref": "#/components/schemas/PdfFillBlockYAML"
- },
- {
- "$ref": "#/components/schemas/SplitPdfBlockYAML"
- },
{
"$ref": "#/components/schemas/WorkflowTriggerBlockYAML"
},
{
"$ref": "#/components/schemas/GoogleSheetsReadBlockYAML"
},
- {
- "$ref": "#/components/schemas/EmailInboxBlockYAML"
- },
{
"$ref": "#/components/schemas/GoogleSheetsWriteBlockYAML"
}
@@ -15826,20 +13454,6 @@
"title": "Save Response As File",
"default": false
},
- "secret_response_paths": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Secret Response Paths"
- },
"parameters": {
"items": {
"oneOf": [
@@ -16036,23 +13650,9 @@
"title": "Download Filename"
},
"save_response_as_file": {
- "type": "boolean",
- "title": "Save Response As File",
- "default": false
- },
- "secret_response_paths": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "Secret Response Paths"
+ "type": "boolean",
+ "title": "Save Response As File",
+ "default": false
},
"parameter_keys": {
"anyOf": [
@@ -16707,7 +14307,7 @@
"type": "number",
"title": "Timeout",
"description": "Timeout in milliseconds",
- "default": 10000
+ "default": 5000
}
},
"type": "object",
@@ -18110,56 +15710,6 @@
"examples": [
"John Doe"
]
- },
- "billing_address": {
- "anyOf": [
- {
- "$ref": "#/components/schemas/CreditCardBillingAddress"
- },
- {
- "type": "null"
- }
- ],
- "description": "Optional billing address associated with the card"
- },
- "billing_email": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Billing Email",
- "description": "Optional billing email address"
- },
- "billing_phone": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Billing Phone",
- "description": "Optional billing phone number"
- },
- "metadata": {
- "anyOf": [
- {
- "additionalProperties": {
- "type": "string"
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Metadata",
- "description": "Optional additional credit card metadata fields"
}
},
"type": "object",
@@ -18581,231 +16131,27 @@
{
"type": "null"
}
- ],
- "title": "Description"
- }
- },
- "type": "object",
- "required": [
- "key"
- ],
- "title": "OutputParameterYAML"
- },
- "PDFFormat": {
- "type": "string",
- "enum": [
- "A4",
- "Letter",
- "Legal",
- "Tabloid"
- ],
- "title": "PDFFormat"
- },
- "PDFParserBlock": {
- "properties": {
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
- },
- "next_block_label": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
- },
- "block_type": {
- "type": "string",
- "const": "pdf_parser",
- "title": "Block Type",
- "default": "pdf_parser"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
- },
- "model": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Model"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "file_url": {
- "type": "string",
- "title": "File Url"
- },
- "json_schema": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Json Schema"
- }
- },
- "type": "object",
- "required": [
- "label",
- "output_parameter",
- "file_url"
- ],
- "title": "PDFParserBlock",
- "description": "DEPRECATED: Use FileParserBlock with file_type=FileType.PDF instead.\nThis block will be removed in a future version."
- },
- "PDFParserBlockYAML": {
- "properties": {
- "block_type": {
- "type": "string",
- "const": "pdf_parser",
- "title": "Block Type",
- "default": "pdf_parser"
- },
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
- },
- "next_block_label": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
- },
- "model": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Model"
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "file_url": {
- "type": "string",
- "title": "File Url"
- },
- "json_schema": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Json Schema"
- }
- },
- "type": "object",
- "required": [
- "label",
- "file_url"
- ],
- "title": "PDFParserBlockYAML"
- },
- "PasswordCredentialResponse": {
- "properties": {
- "username": {
- "type": "string",
- "title": "Username",
- "description": "The username associated with the credential",
- "examples": [
- ]
- },
- "totp_type": {
- "$ref": "#/components/schemas/TotpType",
- "description": "Type of 2FA method used for this credential",
- "default": "none",
- "examples": [
- "authenticator"
- ]
- },
- "totp_identifier": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Totp Identifier",
- "description": "Identifier (email or phone number) used to fetch TOTP codes",
- "examples": [
- "+14155550123"
- ]
+ ],
+ "title": "Description"
}
},
"type": "object",
"required": [
- "username"
+ "key"
],
- "title": "PasswordCredentialResponse",
- "description": "Response model for password credentials — non-sensitive fields only.\n\nSECURITY: Must NEVER include password or TOTP secret."
+ "title": "OutputParameterYAML"
+ },
+ "PDFFormat": {
+ "type": "string",
+ "enum": [
+ "A4",
+ "Letter",
+ "Legal",
+ "Tabloid"
+ ],
+ "title": "PDFFormat"
},
- "PdfFillBlock": {
+ "PDFParserBlock": {
"properties": {
"label": {
"type": "string",
@@ -18826,9 +16172,9 @@
},
"block_type": {
"type": "string",
- "const": "pdf_fill",
+ "const": "pdf_parser",
"title": "Block Type",
- "default": "pdf_fill"
+ "default": "pdf_parser"
},
"output_parameter": {
"$ref": "#/components/schemas/OutputParameter"
@@ -18869,115 +16215,35 @@
"type": "string",
"title": "File Url"
},
- "prompt": {
- "type": "string",
- "title": "Prompt"
- },
- "payload": {
+ "json_schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
- {
- "items": {},
- "type": "array"
- },
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Payload"
- },
- "llm_key": {
- "anyOf": [
- {
- "type": "string"
- },
{
"type": "null"
}
],
- "title": "Llm Key"
- },
- "parameters": {
- "items": {
- "oneOf": [
- {
- "$ref": "#/components/schemas/WorkflowParameter"
- },
- {
- "$ref": "#/components/schemas/ContextParameter"
- },
- {
- "$ref": "#/components/schemas/AWSSecretParameter"
- },
- {
- "$ref": "#/components/schemas/AzureSecretParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
- },
- {
- "$ref": "#/components/schemas/OnePasswordCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/AzureVaultCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/OutputParameter"
- },
- {
- "$ref": "#/components/schemas/CredentialParameter"
- }
- ],
- "discriminator": {
- "propertyName": "parameter_type",
- "mapping": {
- "aws_secret": "#/components/schemas/AWSSecretParameter",
- "azure_secret": "#/components/schemas/AzureSecretParameter",
- "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
- "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
- "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
- "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
- "context": "#/components/schemas/ContextParameter",
- "credential": "#/components/schemas/CredentialParameter",
- "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
- "output": "#/components/schemas/OutputParameter",
- "workflow": "#/components/schemas/WorkflowParameter"
- }
- }
- },
- "type": "array",
- "title": "Parameters",
- "default": []
+ "title": "Json Schema"
}
},
"type": "object",
"required": [
"label",
"output_parameter",
- "file_url",
- "prompt"
+ "file_url"
],
- "title": "PdfFillBlock"
+ "title": "PDFParserBlock",
+ "description": "DEPRECATED: Use FileParserBlock with file_type=FileType.PDF instead.\nThis block will be removed in a future version."
},
- "PdfFillBlockYAML": {
+ "PDFParserBlockYAML": {
"properties": {
"block_type": {
"type": "string",
- "const": "pdf_fill",
+ "const": "pdf_parser",
"title": "Block Type",
- "default": "pdf_fill"
+ "default": "pdf_parser"
},
"label": {
"type": "string",
@@ -19027,62 +16293,67 @@
"type": "string",
"title": "File Url"
},
- "prompt": {
- "type": "string",
- "title": "Prompt"
- },
- "payload": {
+ "json_schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
- {
- "items": {},
- "type": "array"
- },
- {
- "type": "string"
- },
{
"type": "null"
}
],
- "title": "Payload"
+ "title": "Json Schema"
+ }
+ },
+ "type": "object",
+ "required": [
+ "label",
+ "file_url"
+ ],
+ "title": "PDFParserBlockYAML"
+ },
+ "PasswordCredentialResponse": {
+ "properties": {
+ "username": {
+ "type": "string",
+ "title": "Username",
+ "description": "The username associated with the credential",
+ "examples": [
+ ]
},
- "llm_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Llm Key"
+ "totp_type": {
+ "$ref": "#/components/schemas/TotpType",
+ "description": "Type of 2FA method used for this credential",
+ "default": "none",
+ "examples": [
+ "authenticator"
+ ]
},
- "parameter_keys": {
+ "totp_identifier": {
"anyOf": [
{
- "items": {
- "type": "string"
- },
- "type": "array"
+ "type": "string"
},
{
"type": "null"
}
],
- "title": "Parameter Keys"
+ "title": "Totp Identifier",
+ "description": "Identifier (email or phone number) used to fetch TOTP codes",
+ "examples": [
+ "+14155550123"
+ ]
}
},
"type": "object",
"required": [
- "label",
- "file_url",
- "prompt"
+ "username"
],
- "title": "PdfFillBlockYAML"
+ "title": "PasswordCredentialResponse",
+ "description": "Response model for password credentials — non-sensitive fields only.\n\nSECURITY: Must NEVER include password or TOTP secret."
},
"PersistentBrowserType": {
"type": "string",
@@ -19622,107 +16893,16 @@
"RunStatus": {
"type": "string",
"enum": [
- "created",
- "queued",
- "running",
- "timed_out",
- "failed",
- "terminated",
- "completed",
- "canceled"
- ],
- "title": "RunStatus"
- },
- "RunTagHistoryResponse": {
- "properties": {
- "workflow_run_id": {
- "type": "string",
- "title": "Workflow Run Id"
- },
- "events": {
- "items": {
- "$ref": "#/components/schemas/TagHistoryItem"
- },
- "type": "array",
- "title": "Events"
- }
- },
- "type": "object",
- "required": [
- "workflow_run_id",
- "events"
- ],
- "title": "RunTagHistoryResponse"
- },
- "RunTagsBatchRequest": {
- "properties": {
- "workflow_run_ids": {
- "items": {
- "type": "string"
- },
- "type": "array",
- "title": "Workflow Run Ids",
- "description": "Workflow run IDs to fetch tags for."
- }
- },
- "type": "object",
- "title": "RunTagsBatchRequest",
- "description": "Body for ``POST /v1/run-tags`` (used when the run-id list would exceed\nthe URL length cap)."
- },
- "RunTagsBatchResponse": {
- "properties": {
- "run_tags": {
- "additionalProperties": {
- "items": {
- "$ref": "#/components/schemas/TagItem"
- },
- "type": "array"
- },
- "type": "object",
- "title": "Run Tags"
- }
- },
- "type": "object",
- "required": [
- "run_tags"
- ],
- "title": "RunTagsBatchResponse",
- "description": "Response for the run-tags batch endpoint.\n\nRuns with no tags are present with an empty list so the frontend can\ndistinguish \"fetched, none set\" from \"not fetched\" without a second call.\nRuns outside the caller's org are silently absent (no leakage)."
- },
- "RunTagsResponse": {
- "properties": {
- "workflow_run_id": {
- "type": "string",
- "title": "Workflow Run Id"
- },
- "tags": {
- "items": {
- "$ref": "#/components/schemas/TagResponse"
- },
- "type": "array",
- "title": "Tags"
- }
- },
- "type": "object",
- "required": [
- "workflow_run_id",
- "tags"
- ],
- "title": "RunTagsResponse",
- "description": "Current tags for a workflow run."
- },
- "RunType": {
- "type": "string",
- "enum": [
- "task_v1",
- "task_v2",
- "workflow_run",
- "openai_cua",
- "anthropic_cua",
- "ui_tars",
- "yutori_navigator"
+ "created",
+ "queued",
+ "running",
+ "timed_out",
+ "failed",
+ "terminated",
+ "completed",
+ "canceled"
],
- "title": "RunType"
+ "title": "RunStatus"
},
"RunWebhookReplayResponse": {
"properties": {
@@ -20125,7 +17305,7 @@
"type": "number",
"title": "Timeout",
"description": "Timeout in milliseconds",
- "default": 10000
+ "default": 5000
}
},
"type": "object",
@@ -20327,261 +17507,14 @@
"title": "Recipients"
},
"subject": {
- "type": "string",
- "title": "Subject"
- },
- "body": {
- "type": "string",
- "title": "Body"
- },
- "file_attachments": {
- "anyOf": [
- {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "null"
- }
- ],
- "title": "File Attachments"
- }
- },
- "type": "object",
- "required": [
- "label",
- "smtp_host_secret_parameter_key",
- "smtp_port_secret_parameter_key",
- "smtp_username_secret_parameter_key",
- "smtp_password_secret_parameter_key",
- "sender",
- "recipients",
- "subject",
- "body"
- ],
- "title": "SendEmailBlockYAML"
- },
- "SplitPdfBlock": {
- "properties": {
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier for a block; unique within a workflow."
- },
- "next_block_label": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Next Block Label",
- "description": "Optional pointer to the next block label when constructing a DAG. Defaults to sequential order when omitted."
- },
- "block_type": {
- "type": "string",
- "const": "split_pdf",
- "title": "Block Type",
- "default": "split_pdf"
- },
- "output_parameter": {
- "$ref": "#/components/schemas/OutputParameter"
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
- },
- "model": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Model"
- },
- "disable_cache": {
- "type": "boolean",
- "title": "Disable Cache",
- "default": false
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "file_url": {
- "type": "string",
- "title": "File Url"
- },
- "prompt": {
- "type": "string",
- "title": "Prompt"
- },
- "llm_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Llm Key"
- },
- "parameters": {
- "items": {
- "oneOf": [
- {
- "$ref": "#/components/schemas/WorkflowParameter"
- },
- {
- "$ref": "#/components/schemas/ContextParameter"
- },
- {
- "$ref": "#/components/schemas/AWSSecretParameter"
- },
- {
- "$ref": "#/components/schemas/AzureSecretParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenLoginCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenSensitiveInformationParameter"
- },
- {
- "$ref": "#/components/schemas/BitwardenCreditCardDataParameter"
- },
- {
- "$ref": "#/components/schemas/OnePasswordCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/AzureVaultCredentialParameter"
- },
- {
- "$ref": "#/components/schemas/OutputParameter"
- },
- {
- "$ref": "#/components/schemas/CredentialParameter"
- }
- ],
- "discriminator": {
- "propertyName": "parameter_type",
- "mapping": {
- "aws_secret": "#/components/schemas/AWSSecretParameter",
- "azure_secret": "#/components/schemas/AzureSecretParameter",
- "azure_vault_credential": "#/components/schemas/AzureVaultCredentialParameter",
- "bitwarden_credit_card_data": "#/components/schemas/BitwardenCreditCardDataParameter",
- "bitwarden_login_credential": "#/components/schemas/BitwardenLoginCredentialParameter",
- "bitwarden_sensitive_information": "#/components/schemas/BitwardenSensitiveInformationParameter",
- "context": "#/components/schemas/ContextParameter",
- "credential": "#/components/schemas/CredentialParameter",
- "onepassword": "#/components/schemas/OnePasswordCredentialParameter",
- "output": "#/components/schemas/OutputParameter",
- "workflow": "#/components/schemas/WorkflowParameter"
- }
- }
- },
- "type": "array",
- "title": "Parameters",
- "default": []
- }
- },
- "type": "object",
- "required": [
- "label",
- "output_parameter",
- "file_url",
- "prompt"
- ],
- "title": "SplitPdfBlock"
- },
- "SplitPdfBlockYAML": {
- "properties": {
- "block_type": {
- "type": "string",
- "const": "split_pdf",
- "title": "Block Type",
- "default": "split_pdf"
- },
- "label": {
- "type": "string",
- "title": "Label",
- "description": "Author-facing identifier; must be unique per workflow."
- },
- "next_block_label": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Next Block Label",
- "description": "Optional pointer to the label of the next block. When omitted, it will default to sequential order. See [[s-4bnl]]."
- },
- "continue_on_failure": {
- "type": "boolean",
- "title": "Continue On Failure",
- "default": false
- },
- "model": {
- "anyOf": [
- {
- "additionalProperties": true,
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Model"
- },
- "ignore_workflow_system_prompt": {
- "type": "boolean",
- "title": "Ignore Workflow System Prompt",
- "default": false
- },
- "next_loop_on_failure": {
- "type": "boolean",
- "title": "Next Loop On Failure",
- "default": false
- },
- "file_url": {
- "type": "string",
- "title": "File Url"
- },
- "prompt": {
- "type": "string",
- "title": "Prompt"
- },
- "llm_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Llm Key"
+ "type": "string",
+ "title": "Subject"
},
- "parameter_keys": {
+ "body": {
+ "type": "string",
+ "title": "Body"
+ },
+ "file_attachments": {
"anyOf": [
{
"items": {
@@ -20593,16 +17526,22 @@
"type": "null"
}
],
- "title": "Parameter Keys"
+ "title": "File Attachments"
}
},
"type": "object",
"required": [
"label",
- "file_url",
- "prompt"
+ "smtp_host_secret_parameter_key",
+ "smtp_port_secret_parameter_key",
+ "smtp_username_secret_parameter_key",
+ "smtp_password_secret_parameter_key",
+ "sender",
+ "recipients",
+ "subject",
+ "body"
],
- "title": "SplitPdfBlockYAML"
+ "title": "SendEmailBlockYAML"
},
"TOTPCode": {
"properties": {
@@ -20906,21 +17845,6 @@
"type": "array",
"title": "Tags To Delete",
"description": "Tags to soft-delete. List of {key?, value?} targets."
- },
- "colors": {
- "anyOf": [
- {
- "additionalProperties": {
- "type": "string"
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ],
- "title": "Colors",
- "description": "Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color."
}
},
"type": "object",
@@ -21141,16 +18065,6 @@
"removed_from_workflow_count": {
"type": "integer",
"title": "Removed From Workflow Count"
- },
- "removed_from_run_count": {
- "type": "integer",
- "title": "Removed From Run Count",
- "default": 0
- },
- "removed_count": {
- "type": "integer",
- "title": "Removed Count",
- "default": 0
}
},
"type": "object",
@@ -21221,156 +18135,6 @@
"title": "TagResponse",
"description": "Current state of one tag (``GET /v1/workflows/{wpid}/tags`` row).\n``key`` is null for a standalone label."
},
- "TagValue": {
- "properties": {
- "key": {
- "type": "string",
- "title": "Key"
- },
- "value": {
- "type": "string",
- "title": "Value"
- },
- "color": {
- "type": "string",
- "title": "Color"
- },
- "workflow_count": {
- "type": "integer",
- "title": "Workflow Count",
- "description": "Number of non-deleted workflows currently carrying this (key, value) label.",
- "default": 0
- }
- },
- "type": "object",
- "required": [
- "key",
- "value",
- "color"
- ],
- "title": "TagValue",
- "description": "Tag-value color registry entry: the palette color assigned to a grouped\n(key, value) pair."
- },
- "TagValueDelete": {
- "properties": {
- "value": {
- "type": "string",
- "title": "Value",
- "description": "Tag value (label) under the key to soft-delete."
- }
- },
- "type": "object",
- "required": [
- "value"
- ],
- "title": "TagValueDelete",
- "description": "Body for ``DELETE /v1/tag-values/{key}``. The value rides in the body, not the\npath, so values containing ``/`` stay addressable."
- },
- "TagValueDeleteResponse": {
- "properties": {
- "key": {
- "type": "string",
- "title": "Key"
- },
- "value": {
- "type": "string",
- "title": "Value"
- },
- "removed_from_workflow_count": {
- "type": "integer",
- "title": "Removed From Workflow Count"
- },
- "removed_from_run_count": {
- "type": "integer",
- "title": "Removed From Run Count",
- "default": 0
- },
- "removed_count": {
- "type": "integer",
- "title": "Removed Count",
- "default": 0
- }
- },
- "type": "object",
- "required": [
- "key",
- "value",
- "removed_from_workflow_count"
- ],
- "title": "TagValueDeleteResponse",
- "description": "Response for ``DELETE /v1/tag-values/{key}``."
- },
- "TagValueRename": {
- "properties": {
- "value": {
- "type": "string",
- "title": "Value",
- "description": "Current tag value (label) under the key to rename."
- },
- "new_value": {
- "type": "string",
- "title": "New Value",
- "description": "New tag value (label) to rename it to."
- }
- },
- "type": "object",
- "required": [
- "value",
- "new_value"
- ],
- "title": "TagValueRename",
- "description": "Body for ``PATCH /v1/tag-values/{key}/rename``. Both the current and the new\nvalue ride in the body so values containing ``/`` stay addressable."
- },
- "TagValueRenameResponse": {
- "properties": {
- "key": {
- "type": "string",
- "title": "Key"
- },
- "value": {
- "type": "string",
- "title": "Value"
- },
- "color": {
- "type": "string",
- "title": "Color"
- },
- "renamed_workflow_count": {
- "type": "integer",
- "title": "Renamed Workflow Count"
- }
- },
- "type": "object",
- "required": [
- "key",
- "value",
- "color",
- "renamed_workflow_count"
- ],
- "title": "TagValueRenameResponse",
- "description": "Response for ``PATCH /v1/tag-values/{key}/rename``: the renamed label with its\ncarried-over color and the number of workflows re-tagged."
- },
- "TagValueUpdate": {
- "properties": {
- "value": {
- "type": "string",
- "title": "Value",
- "description": "Tag value (label) under the key to recolor."
- },
- "color": {
- "type": "string",
- "title": "Color",
- "description": "Palette color name to assign to this (key, value)."
- }
- },
- "type": "object",
- "required": [
- "value",
- "color"
- ],
- "title": "TagValueUpdate",
- "description": "Body for ``PATCH /v1/tag-values/{key}``. The value rides in the body, not the\npath, so values containing ``/`` stay addressable."
- },
"TagsResponse": {
"properties": {
"workflow_permanent_id": {
@@ -23846,7 +20610,7 @@
"type": "number",
"title": "Timeout",
"description": "Timeout in milliseconds",
- "default": 10000
+ "default": 5000
}
},
"type": "object",
@@ -24400,8 +21164,8 @@
},
"confidence_float": {
"type": "number",
- "maximum": 1,
- "minimum": 0,
+ "maximum": 1.0,
+ "minimum": 0.0,
"title": "Confidence Float"
},
"error_type": {
@@ -24752,11 +21516,6 @@
"type": "boolean",
"title": "Include Extracted Text",
"default": true
- },
- "without_page_information": {
- "type": "boolean",
- "title": "Without Page Information",
- "default": false
}
},
"type": "object",
@@ -24872,11 +21631,6 @@
"type": "boolean",
"title": "Disable Cache",
"default": false
- },
- "without_page_information": {
- "type": "boolean",
- "title": "Without Page Information",
- "default": false
}
},
"type": "object",
@@ -25261,17 +22015,8 @@
{
"$ref": "#/components/schemas/GoogleSheetsReadBlock"
},
- {
- "$ref": "#/components/schemas/EmailInboxBlock"
- },
{
"$ref": "#/components/schemas/GoogleSheetsWriteBlock"
- },
- {
- "$ref": "#/components/schemas/PdfFillBlock"
- },
- {
- "$ref": "#/components/schemas/SplitPdfBlock"
}
],
"discriminator": {
@@ -25281,7 +22026,6 @@
"code": "#/components/schemas/CodeBlock",
"conditional": "#/components/schemas/ConditionalBlock",
"download_to_s3": "#/components/schemas/DownloadToS3Block",
- "email_inbox": "#/components/schemas/EmailInboxBlock",
"extraction": "#/components/schemas/ExtractionBlock",
"file_download": "#/components/schemas/FileDownloadBlock",
"file_upload": "#/components/schemas/FileUploadBlock",
@@ -25294,11 +22038,9 @@
"human_interaction": "#/components/schemas/HumanInteractionBlock",
"login": "#/components/schemas/LoginBlock",
"navigation": "#/components/schemas/NavigationBlock",
- "pdf_fill": "#/components/schemas/PdfFillBlock",
"pdf_parser": "#/components/schemas/PDFParserBlock",
"print_page": "#/components/schemas/PrintPageBlock",
"send_email": "#/components/schemas/SendEmailBlock",
- "split_pdf": "#/components/schemas/SplitPdfBlock",
"task": "#/components/schemas/TaskBlock",
"task_v2": "#/components/schemas/TaskV2Block",
"text_prompt": "#/components/schemas/TextPromptBlock",
@@ -25469,21 +22211,12 @@
{
"$ref": "#/components/schemas/PrintPageBlockYAML"
},
- {
- "$ref": "#/components/schemas/PdfFillBlockYAML"
- },
- {
- "$ref": "#/components/schemas/SplitPdfBlockYAML"
- },
{
"$ref": "#/components/schemas/WorkflowTriggerBlockYAML"
},
{
"$ref": "#/components/schemas/GoogleSheetsReadBlockYAML"
},
- {
- "$ref": "#/components/schemas/EmailInboxBlockYAML"
- },
{
"$ref": "#/components/schemas/GoogleSheetsWriteBlockYAML"
}
@@ -25605,11 +22338,6 @@
"title": "Persist Browser Session",
"default": false
},
- "pin_saved_session_ip": {
- "type": "boolean",
- "title": "Pin Saved Session Ip",
- "default": false
- },
"browser_profile_id": {
"anyOf": [
{
@@ -25621,17 +22349,6 @@
],
"title": "Browser Profile Id"
},
- "browser_profile_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Browser Profile Key"
- },
"model": {
"anyOf": [
{
@@ -25724,11 +22441,6 @@
"title": "Adaptive Caching",
"default": false
},
- "enable_self_healing": {
- "type": "boolean",
- "title": "Enable Self Healing",
- "default": false
- },
"code_version": {
"anyOf": [
{
@@ -25811,11 +22523,6 @@
],
"title": "Edited By"
},
- "copilot_authored": {
- "type": "boolean",
- "title": "Copilot Authored",
- "default": false
- },
"created_at": {
"type": "string",
"format": "date-time",
@@ -25933,11 +22640,6 @@
"title": "Persist Browser Session",
"default": false
},
- "pin_saved_session_ip": {
- "type": "boolean",
- "title": "Pin Saved Session Ip",
- "default": false
- },
"browser_profile_id": {
"anyOf": [
{
@@ -25949,17 +22651,6 @@
],
"title": "Browser Profile Id"
},
- "browser_profile_key": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Browser Profile Key"
- },
"model": {
"anyOf": [
{
@@ -25995,8 +22686,8 @@
"anyOf": [
{
"type": "integer",
- "maximum": 480,
- "minimum": 1
+ "maximum": 480.0,
+ "minimum": 1.0
},
{
"type": "null"
@@ -26063,23 +22754,12 @@
"title": "Adaptive Caching",
"default": false
},
- "enable_self_healing": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
- "title": "Enable Self Healing"
- },
"code_version": {
"anyOf": [
{
"type": "integer",
- "maximum": 2,
- "minimum": 1
+ "maximum": 2.0,
+ "minimum": 1.0
},
{
"type": "null"
@@ -26272,17 +22952,8 @@
{
"$ref": "#/components/schemas/GoogleSheetsReadBlock"
},
- {
- "$ref": "#/components/schemas/EmailInboxBlock"
- },
{
"$ref": "#/components/schemas/GoogleSheetsWriteBlock"
- },
- {
- "$ref": "#/components/schemas/PdfFillBlock"
- },
- {
- "$ref": "#/components/schemas/SplitPdfBlock"
}
],
"discriminator": {
@@ -26292,7 +22963,6 @@
"code": "#/components/schemas/CodeBlock",
"conditional": "#/components/schemas/ConditionalBlock",
"download_to_s3": "#/components/schemas/DownloadToS3Block",
- "email_inbox": "#/components/schemas/EmailInboxBlock",
"extraction": "#/components/schemas/ExtractionBlock",
"file_download": "#/components/schemas/FileDownloadBlock",
"file_upload": "#/components/schemas/FileUploadBlock",
@@ -26305,11 +22975,9 @@
"human_interaction": "#/components/schemas/HumanInteractionBlock",
"login": "#/components/schemas/LoginBlock",
"navigation": "#/components/schemas/NavigationBlock",
- "pdf_fill": "#/components/schemas/PdfFillBlock",
"pdf_parser": "#/components/schemas/PDFParserBlock",
"print_page": "#/components/schemas/PrintPageBlock",
"send_email": "#/components/schemas/SendEmailBlock",
- "split_pdf": "#/components/schemas/SplitPdfBlock",
"task": "#/components/schemas/TaskBlock",
"task_v2": "#/components/schemas/TaskV2Block",
"text_prompt": "#/components/schemas/TextPromptBlock",
@@ -26371,15 +23039,9 @@
"WorkflowDefinitionYAML": {
"properties": {
"version": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Version"
+ "type": "integer",
+ "title": "Version",
+ "default": 1
},
"parameters": {
"items": {
@@ -26509,21 +23171,12 @@
{
"$ref": "#/components/schemas/PrintPageBlockYAML"
},
- {
- "$ref": "#/components/schemas/PdfFillBlockYAML"
- },
- {
- "$ref": "#/components/schemas/SplitPdfBlockYAML"
- },
{
"$ref": "#/components/schemas/WorkflowTriggerBlockYAML"
},
{
"$ref": "#/components/schemas/GoogleSheetsReadBlockYAML"
},
- {
- "$ref": "#/components/schemas/EmailInboxBlockYAML"
- },
{
"$ref": "#/components/schemas/GoogleSheetsWriteBlockYAML"
}
@@ -26535,7 +23188,6 @@
"code": "#/components/schemas/CodeBlockYAML",
"conditional": "#/components/schemas/ConditionalBlockYAML",
"download_to_s3": "#/components/schemas/DownloadToS3BlockYAML",
- "email_inbox": "#/components/schemas/EmailInboxBlockYAML",
"extraction": "#/components/schemas/ExtractionBlockYAML",
"file_download": "#/components/schemas/FileDownloadBlockYAML",
"file_upload": "#/components/schemas/FileUploadBlockYAML",
@@ -26548,11 +23200,9 @@
"human_interaction": "#/components/schemas/HumanInteractionBlockYAML",
"login": "#/components/schemas/LoginBlockYAML",
"navigation": "#/components/schemas/NavigationBlockYAML",
- "pdf_fill": "#/components/schemas/PdfFillBlockYAML",
"pdf_parser": "#/components/schemas/PDFParserBlockYAML",
"print_page": "#/components/schemas/PrintPageBlockYAML",
"send_email": "#/components/schemas/SendEmailBlockYAML",
- "split_pdf": "#/components/schemas/SplitPdfBlockYAML",
"task": "#/components/schemas/TaskBlockYAML",
"task_v2": "#/components/schemas/TaskV2BlockYAML",
"text_prompt": "#/components/schemas/TextPromptBlockYAML",
@@ -27577,17 +24227,6 @@
],
"title": "Body"
},
- "prompt": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "title": "Prompt"
- },
"instructions": {
"anyOf": [
{
@@ -27674,17 +24313,6 @@
"type": "null"
}
]
- },
- "downloaded_file_count": {
- "anyOf": [
- {
- "type": "integer"
- },
- {
- "type": "null"
- }
- ],
- "title": "Downloaded File Count"
}
},
"type": "object",
@@ -27837,8 +24465,8 @@
"anyOf": [
{
"type": "integer",
- "maximum": 480,
- "minimum": 1
+ "maximum": 480.0,
+ "minimum": 1.0
},
{
"type": "null"
@@ -28082,8 +24710,8 @@
"anyOf": [
{
"type": "integer",
- "maximum": 480,
- "minimum": 1
+ "maximum": 480.0,
+ "minimum": 1.0
},
{
"type": "null"
@@ -28751,14 +25379,7 @@
"title": "Timezone"
},
"enabled": {
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "type": "null"
- }
- ],
+ "type": "boolean",
"title": "Enabled",
"default": true
},
@@ -29161,4 +25782,4 @@
"x-fern-server-name": "Local"
}
]
-}
\ No newline at end of file
+}
diff --git a/skyvern-frontend/src/routes/history/RunHistory.test.tsx b/skyvern-frontend/src/routes/history/RunHistory.test.tsx
index 1b65e3d8a..87cb5efac 100644
--- a/skyvern-frontend/src/routes/history/RunHistory.test.tsx
+++ b/skyvern-frontend/src/routes/history/RunHistory.test.tsx
@@ -34,6 +34,8 @@ const workflowRun: TaskRunListItem = {
const runsData = [workflowRun];
const runsQueryResult = { data: runsData, isFetching: false };
+const { useRunsQuerySpy } = vi.hoisted(() => ({ useRunsQuerySpy: vi.fn() }));
+
vi.mock("use-debounce", () => ({
useDebounce: <T,>(value: T): [T] => [value],
}));
@@ -47,6 +49,7 @@ const runsQueryCalls: Array<Record<string, unknown>> = [];
vi.mock("@/hooks/useRunsQuery", () => ({
useRunsQuery: (props: Record<string, unknown>) => {
+ useRunsQuerySpy(props);
runsQueryCalls.push(props);
return runsQueryResult;
},
@@ -162,6 +165,37 @@ afterEach(() => {
vi.clearAllMocks();
});
+describe("RunHistory search highlighting", () => {
+ it("does not highlight the run id for a sub-3-char query", () => {
+ const { container } = renderRunHistory();
+ fireEvent.change(screen.getByLabelText("search-runs"), {
+ target: { value: "12" },
+ });
+
+ expect(container.innerHTML).not.toContain("bg-blue-500/30");
+ });
+
+ it("highlights the run id once the query reaches 3 chars", () => {
+ const { container } = renderRunHistory();
+ fireEvent.change(screen.getByLabelText("search-runs"), {
+ target: { value: "123" },
+ });
+
+ expect(container.innerHTML).toContain("bg-blue-500/30");
+ });
+
+ it("sends a trimmed search value to the runs query, not just a trimmed length check", () => {
+ renderRunHistory();
+ fireEvent.change(screen.getByLabelText("search-runs"), {
+ target: { value: " 123" },
+ });
+
+ const calls = useRunsQuerySpy.mock.calls;
+ const lastCall = calls[calls.length - 1]?.[0] as { search?: string };
+ expect(lastCall.search).toBe("123");
+ });
+});
+
describe("RunHistory inputs during filtering", () => {
it("keeps Run Inputs collapsed while a search is active", () => {
renderRunHistory();
diff --git a/skyvern-frontend/src/routes/history/RunHistory.tsx b/skyvern-frontend/src/routes/history/RunHistory.tsx
index fd9300325..f4ed9c120 100644
--- a/skyvern-frontend/src/routes/history/RunHistory.tsx
+++ b/skyvern-frontend/src/routes/history/RunHistory.tsx
@@ -186,9 +186,17 @@ function RunHistory() {
const [search, setSearch] = useState("");
const [debouncedSearch] = useDebounce(search, 500);
- const effectiveSearch = workflowPermanentIdFilter || debouncedSearch;
-
- const { data: rawRuns, isFetching } = useRunsQuery({
+ // The /runs search_key requires min 3 chars (trigram index); shorter queries 422.
+ const trimmedSearch = debouncedSearch.trim();
+ const textSearch = trimmedSearch.length >= 3 ? trimmedSearch : "";
+ const effectiveSearch = workflowPermanentIdFilter || textSearch;
+
+ const {
+ data: rawRuns,
+ isFetching,
+ isError,
+ refetch,
+ } = useRunsQuery({
page,
pageSize: itemsPerPage,
statusFilters,
@@ -278,6 +286,26 @@ function RunHistory() {
));
}
+ // Failed to load runs
+ if (isError) {
+ return (
+ <TableMessageRow colSpan={6}>
+ <div className="flex items-center justify-center gap-3">
+ <span>Failed to load runs.</span>
+ <Button
+ variant="secondary"
+ size="sm"
+ onClick={() => {
+ refetch();
+ }}
+ >
+ Retry
+ </Button>
+ </div>
+ </TableMessageRow>
+ );
+ }
+
// No runs found
if (runs?.length === 0) {
return <TableMessageRow colSpan={6}>No runs found</TableMessageRow>;
@@ -330,7 +358,7 @@ function RunHistory() {
}}
>
<TableCell className="max-w-0 truncate" title={run.run_id}>
- <HighlightText text={run.run_id} query={debouncedSearch} />
+ <HighlightText text={run.run_id} query={textSearch} />
</TableCell>
<TableCell
className="max-w-0 truncate"
@@ -417,7 +445,7 @@ function RunHistory() {
const hasActiveFilters =
statusFilters.length > 0 ||
runTypeGroups.length > 0 ||
- !!debouncedSearch ||
+ !!textSearch ||
!!workflowPermanentIdFilter;
const showOnboardingEmpty =
!isFetching &&