---
title: "Get a one-time upload link for a big file"
method: POST
path: "/tasks/{tid}/attachments/upload-url"
tags: ["tasks"]
---

# Get a one-time upload link for a big file

`POST /tasks/{tid}/attachments/upload-url`

## Request

- Base URL: `https://task.igordudnek.com/api/v1`
- URL: `https://task.igordudnek.com/api/v1/tasks/{tid}/attachments/upload-url`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `lt_access`

For files too big to send through a tool call (MCP create_upload_url). Same rights as a normal upload. Returns upload_url — PUT the raw file bytes there (no Authorization header), once, within 15 minutes.

## Request body

- object
  - `content_type` string
  - `filename` string, required

## Response `201`

Upload link

- object
  - `curl_example` string
  - `expires_at` string, date-time, required
  - `filename` string
  - `headers` object
  - `max_bytes` integer
  - `method` 'PUT', required
  - `upload_url` string, required

---

[API](https://skmtc.dev/loopertask/apis/loopertask-api.md) · [All operations](https://skmtc.dev/loopertask/apis/loopertask-api/llms.txt) · [OpenAPI document](https://skmtc.dev/loopertask/apis/loopertask-api/revisions/5d9903f15162?raw)