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

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"

Response

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

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

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: API key and scopes.
• Errors and limits: error responses and rate limits.
• All endpoints: full list.