Create a file upload

Step 1 for an agent to send a new file: give the purpose (message = send / album, story = post a story, photo = account / group / bot photo, campaign = a campaign "send file" block), accountId (or campaignId), file name, type and size. Returns uploadUrl (PUT the raw bytes with headers, valid 2 hours), then call files.complete_upload. Up to 50 MB (profile photos 10 MB); 20 waiting + 50 ready-unused files per connection. If you cannot PUT, give the user the link to upload it themselves.

#Overview

#Input fields

#Example request

curl -X POST https://tlg.builera.app/api/public/v2/ops/files.create_upload \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purpose":"message","fileName":"…","mime":"…","size":1}'

#Output fields (data)

#Example answer

{
  "data": {
    "ok": true,
    "uploadId": "00000000-0000-4000-8000-000000000000",
    "uploadUrl": "text",
    "method": "PUT",
    "headers": {
      "content-type": "text",
      "x-upsert": "text"
    },
    "maxBytes": 1,
    "completeBefore": "text"
  }
}

#Using it over MCP

Not listed on any profile: call tools_describe then tools_run with code: "files.create_upload". Tool name when listed: files_create_upload.