mirror of
https://github.com/Skyvern-AI/skyvern.git
synced 2026-04-29 12:10:28 +00:00
docs: Major revamp to Developers and SDK Reference Tabs, Added Documentation for Page/Agent/Browser Methods (#5571)
This commit is contained in:
parent
6ff9350619
commit
e376b8a7e9
161 changed files with 9401 additions and 13566 deletions
80
docs/sdk-reference/helpers/upload-file.mdx
Normal file
80
docs/sdk-reference/helpers/upload-file.mdx
Normal file
|
|
@ -0,0 +1,80 @@
|
|||
---
|
||||
title: "upload_file"
|
||||
slug: sdk-reference/helpers/upload-file
|
||||
---
|
||||
|
||||
Upload a file to Skyvern's storage. Returns a presigned URL and S3 URI you can reference in tasks and workflows.
|
||||
|
||||
<CodeGroup>
|
||||
```python Python
|
||||
with open("data.csv", "rb") as f:
|
||||
upload = await client.upload_file(file=f)
|
||||
print(upload.s3uri) # s3://skyvern-uploads/...
|
||||
print(upload.presigned_url) # https://...signed download URL
|
||||
```
|
||||
|
||||
```typescript TypeScript
|
||||
import fs from "fs";
|
||||
|
||||
const upload = await skyvern.uploadFile({
|
||||
file: fs.createReadStream("data.csv"),
|
||||
});
|
||||
console.log(upload.s3_uri); // s3://skyvern-uploads/...
|
||||
console.log(upload.presigned_url); // https://...signed download URL
|
||||
```
|
||||
</CodeGroup>
|
||||
|
||||
### Parameters
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
|-----------|------|----------|-------------|
|
||||
| `file` | `File` (Python) / `File \| ReadStream \| Blob` (TS) | Yes | The file to upload. |
|
||||
| `request_options` | `RequestOptions` | No | Per-request configuration (see below). |
|
||||
|
||||
### Returns `UploadFileResponse`
|
||||
|
||||
| Field | Type | Description |
|
||||
|-------|------|-------------|
|
||||
| `s3uri` (Python) / `s3_uri` (TS) | `str` | S3 URI for the uploaded file. |
|
||||
| `presigned_url` | `str` | Pre-signed download URL. |
|
||||
|
||||
---
|
||||
|
||||
### Request options
|
||||
|
||||
|
||||
Override timeout, retries, or headers for this call by passing `request_options` (Python) or a second options argument (TypeScript).
|
||||
|
||||
<CodeGroup>
|
||||
```python Python
|
||||
from skyvern.client.core import RequestOptions
|
||||
|
||||
request_options=RequestOptions(
|
||||
timeout_in_seconds=120,
|
||||
max_retries=3,
|
||||
additional_headers={"x-custom-header": "value"},
|
||||
)
|
||||
```
|
||||
|
||||
```typescript TypeScript
|
||||
// Pass as second argument to any method
|
||||
{
|
||||
timeoutInSeconds: 120,
|
||||
maxRetries: 3,
|
||||
headers: { "x-custom-header": "value" },
|
||||
}
|
||||
```
|
||||
</CodeGroup>
|
||||
|
||||
| Option (Python) | Option (TypeScript) | Type | Description |
|
||||
|-----------------|---------------------|------|-------------|
|
||||
| `timeout_in_seconds` | `timeoutInSeconds` | `int` / `number` | HTTP timeout in seconds. |
|
||||
| `max_retries` | `maxRetries` | `int` / `number` | Retry count. |
|
||||
| `additional_headers` | `headers` | `dict` / `Record<string, string>` | Extra headers. |
|
||||
| `additional_query_parameters` | - | `dict` | Extra query parameters. |
|
||||
| `additional_body_parameters` | - | `dict` | Extra body parameters. |
|
||||
| - | `abortSignal` | `AbortSignal` | Signal to cancel the request. |
|
||||
| - | `apiKey` | `string` | Override API key. |
|
||||
|
||||
|
||||
---
|
||||
Loading…
Add table
Add a link
Reference in a new issue