Skyvern/skyvern-ts/client/reference.md

Reference

client.getWorkflowVersions(workflowPermanentId, { ...params }) -> Skyvern.Workflow[]

📝 Description

Get all versions of a workflow by its permanent ID.

🔌 Usage

await client.getWorkflowVersions("workflow_permanent_id", {
    template: true
});

⚙️ Parameters

workflowPermanentId: string

request: Skyvern.GetWorkflowVersionsRequest

requestOptions: SkyvernClient.RequestOptions

Artifacts

client.artifacts.getArtifactContent(artifactId) -> unknown

📝 Description

Download the raw content of an artifact (supports bundled artifacts).

🔌 Usage

await client.artifacts.getArtifactContent("artifact_id");

⚙️ Parameters

artifactId: string

requestOptions: Artifacts.RequestOptions

Scripts

client.scripts.runScript(scriptId) -> unknown

📝 Description

Run a script

🔌 Usage

await client.scripts.runScript("s_abc123");

⚙️ Parameters

scriptId: string — The unique identifier of the script

requestOptions: Scripts.RequestOptions

Schedules

client.schedules.listAll({ ...params }) -> Skyvern.OrganizationScheduleListResponse

🔌 Usage

await client.schedules.listAll({
    page: 1,
    page_size: 1,
    status: "active",
    search: "search"
});

⚙️ Parameters

request: Skyvern.SchedulesListAllRequest

requestOptions: Schedules.RequestOptions

client.schedules.list(workflowPermanentId) -> Skyvern.WorkflowScheduleListResponse

🔌 Usage

await client.schedules.list("workflow_permanent_id");

⚙️ Parameters

workflowPermanentId: string

requestOptions: Schedules.RequestOptions

client.schedules.create(workflowPermanentId, { ...params }) -> Skyvern.WorkflowScheduleResponse

🔌 Usage

await client.schedules.create("workflow_permanent_id", {
    cron_expression: "cron_expression",
    timezone: "timezone"
});

⚙️ Parameters

workflowPermanentId: string

request: Skyvern.WorkflowScheduleUpsertRequest

requestOptions: Schedules.RequestOptions

client.schedules.get(workflowPermanentId, workflowScheduleId) -> Skyvern.WorkflowScheduleResponse

🔌 Usage

await client.schedules.get("workflow_permanent_id", "workflow_schedule_id");

⚙️ Parameters

workflowPermanentId: string

workflowScheduleId: string

requestOptions: Schedules.RequestOptions

client.schedules.update(workflowPermanentId, workflowScheduleId, { ...params }) -> Skyvern.WorkflowScheduleResponse

🔌 Usage

await client.schedules.update("workflow_permanent_id", "workflow_schedule_id", {
    cron_expression: "cron_expression",
    timezone: "timezone"
});

⚙️ Parameters

workflowPermanentId: string

workflowScheduleId: string

request: Skyvern.WorkflowScheduleUpsertRequest

requestOptions: Schedules.RequestOptions

client.schedules.delete(workflowPermanentId, workflowScheduleId) -> Skyvern.DeleteScheduleResponse

🔌 Usage

await client.schedules.delete("workflow_permanent_id", "workflow_schedule_id");

⚙️ Parameters

workflowPermanentId: string

workflowScheduleId: string

requestOptions: Schedules.RequestOptions

client.schedules.enable(workflowPermanentId, workflowScheduleId) -> Skyvern.WorkflowScheduleResponse

🔌 Usage

await client.schedules.enable("workflow_permanent_id", "workflow_schedule_id");

⚙️ Parameters

workflowPermanentId: string

workflowScheduleId: string

requestOptions: Schedules.RequestOptions

client.schedules.disable(workflowPermanentId, workflowScheduleId) -> Skyvern.WorkflowScheduleResponse

🔌 Usage

await client.schedules.disable("workflow_permanent_id", "workflow_schedule_id");

⚙️ Parameters

workflowPermanentId: string

workflowScheduleId: string

requestOptions: Schedules.RequestOptions

Agents

client.agents.resetWorkflowBrowserProfile(workflowPermanentId) -> void

📝 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.

🔌 Usage

await client.agents.resetWorkflowBrowserProfile("wpid_123");

⚙️ Parameters

workflowPermanentId: string — The permanent ID of the workflow. Starts with wpid_.

requestOptions: Agents.RequestOptions