---
title: "Copy from URL"
method: POST
path: "/operations/copyurl"
---

# Copy from URL

`POST /operations/copyurl`

Downloads a public URL and stores it at the requested remote path.

## Query parameters

- `fs` string
- `remote` string
- `url` string
- `autoFilename` boolean
- `_group` string
- `_async` boolean

## Headers

- `Prefer` 'respond-async'

## Request body

- OperationsCopyurlRequest
  - `fs` string — Remote name or path that will receive the downloaded file, e.g. `drive:`.
  - `remote` string — Destination path within `fs` where the fetched object will be stored.
  - `url` string — Source URL to fetch the object from.
  - `autoFilename` boolean — Set to true to derive the destination filename from the URL.
  - `_group` string — Assign the request to a custom stats group.
  - `_async` boolean — Run the command asynchronously. Returns a job id immediately.

## Response `200`

Request succeeded returning an empty JSON object.

- object

## Other responses

- `202` — Request accepted for async processing. Poll /job/status with the returned jobid.
- `4XX` — Any error response (HTTP 4xx/5xx)
- `5XX` — Any error response (HTTP 4xx/5xx)

## Changes

> 21 revisions in range; 17 could not be searched.

- **2026-06-05** `2849bf2803ce` — 1 warning, 2 info
  - removed the optional property `jobid` from the response with the `200` status
  - added the new optional `header` request parameter `Prefer`
  - added the success response with the status `202`
- **2025-12-06** `30e239e76ba1` — 9 breaking, 1 warning
  - removed the request body
  - the `query` request parameter `fs` became required
  - the `query` request parameter `remote` became required
  - the `query` request parameter `url` became required
  - …6 more

[Change history](https://skmtc.dev/rclone/apis/rclone-rc-api/changes/operations/copyurl/post.md)

---

[API](https://skmtc.dev/rclone/apis/rclone-rc-api.md) · [All operations](https://skmtc.dev/rclone/apis/rclone-rc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rclone/rclone-rc-api/revisions/adc0c129da4f/schema)