Files

Upload a file

Upload a file to Skyvern storage so runs can reference it as an input. Returns the file id, its storage URI, a presigned download URL, and the expiry implied by the requested retention period.

post/v1/upload_file

Headers

x-api-keystring nullable

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

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

Response

Successful Response

s3_uristring required

S3 URI where the file was uploaded

presigned_urlstring required

Presigned URL to access the uploaded file

file_idstring nullable

Identifier for this upload. Pass it to DELETE /v1/files/{file_id} to delete the file.

expires_atstring date-time nullable

When the file will be deleted, if a retention_days was supplied. Null means the file has no expiry of its own and follows the organization's data retention policy.

Changes