Media

Upload link files: GET /upload-link/:id

A feltöltési linken beérkezett fájlok, a posztba tehető címmel.

Path

Method and path

GEThttps://api.posty.hu/public/v1/upload-link/:id

Authorization

media:write

operationId

getUploadLinkFiles

What has arrived on the upload link so far, oldest first. Each item's path value can be passed into a post.

status stays "empty" until the first file arrives. That is not an error: the user is not done yet, or they spoke up before the last file finished uploading. Ask them, and query again.

Parameters

Name	Location	Type	Required	Description
id	útvonal	string	yes	The id from the POST /upload-link response.

Request

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

Response

Example response structure. The OpenAPI document contains the authoritative schema for each field.

{
  "id": "kR3mQ7xP2nLa",
  "status": "ready",
  "count": 1,
  "files": [
    {
      "id": "cmd1a2b3c4d5",
      "name": "termekvideo.mp4",
      "path": "https://uploads.posty.hu/2026/09/termekvideo.mp4",
      "type": "video"
    }
  ]
}

Important

It only searches inside the caller's workspace: a link ID from another workspace returns an empty response, not an error.

Authentication: API key and scopes.
Errors and limits: error responses and rate limits.
All endpoints: full list.

Is something missing from this page? Email [email protected] or use the form on the Help page.