---
title: "Upload from URL"
method: POST
path: "/upload/url"
tags: ["upload"]
---

# Upload from URL

`POST /upload/url`

Upload to Gigasheet from the given url, optionally specifying file name
and parent directory. Gigasheet will run the normal parsing flow and
create multiple entries if appropriate.

## Request body

- UploaderRequest
  - `callbackUrl` string
  - `folderHandle` string
  - `name` string
  - `skipNotification` boolean
  - `skipTypeInference` boolean — If set, all columns are treated as string
  - `targetHandle` string — If not blank, records will be appended to this handle
  - `url` string, required

## Response `200`

ok

- unknown

## Other responses

- `400` — invalid request payload or bad parent directory
- `403` — upload exceeds account storage limit
- `500` — Internal Server Error

---

[API](https://skmtc.net/freshdesk/apis/gigasheet-api.md) · [All operations](https://skmtc.net/freshdesk/apis/gigasheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freshdesk/gigasheet-api/revisions/d1e5cbb24557/schema)