---
title: "Upload link: POST /upload-link | Posty dokumentáció"
description: "Böngészős feltöltési link, ha a fájl a felhasználó eszközén van."
canonical: https://posty.hu/en/docs/api/endpoints/feltoltesi-link
source: https://posty.hu/en/docs/api/endpoints/feltoltesi-link.md
---

Media

# Upload link: POST /upload-link

Böngészős feltöltési link, ha a fájl a felhasználó eszközén van.

## Path

Method and path

POSThttps://api.posty.hu/public/v1/upload-link

Authorization

`media:write`

operationId

`createUploadLink`

Returns a browser link where the user drops an image or video from their computer or phone. The file goes straight into the workspace media library, tagged with the link ID.

This is for when the caller does not have the file. An agent running in a chat cannot take a 400 MB video, and there is no public URL for it either. For a CLI that can see the file on disk, the /upload endpoint is the simpler path.

The link is valid for two hours, accepts multiple files, and works without signing in. It can only upload into the one workspace it was created for: it cannot read or post.

## Request

```
curl -X POST https://api.posty.hu/public/v1/upload-link \
  -H "Authorization: psty_a_kulcsod"
```

Kód másolása

## Response

Example response structure. The [OpenAPI document](https://posty.hu/openapi.json) contains the authoritative schema for each field.

```
{
  "id": "kR3mQ7xP2nLa",
  "url": "https://posty.hu/feltoltes/eyJhbGciOi…",
  "expiresAt": "2026-09-08T14:00:00.000Z"
}
```

Kód másolása

## Important

- The url is for the user: show it to them as-is. When they say they are done, GET /upload-link/:id returns what arrived.

## Related

- [Authentication](https://posty.hu/en/docs/api/authentication): API key and scopes.
- [Errors and limits](https://posty.hu/en/docs/api/errors): error responses and rate limits.
- [All endpoints](https://posty.hu/en/docs/api/endpoints): full list.

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.