Media uploads
The handoff for a file only you can supply — phone photo to post.
The upload handoff exists for the one thing an agent cannot do: take a file from you. The photo on your phone, the screenshot on your laptop, the image you pasted into the chat — the agent can see it, but it cannot forward it. So you hand it to Pressbotics directly, and the agent only ever holds a reference.
The four steps
- 1The agent calls create_media_upload with the site and a short description of what the file is for. It gets back an upload link and an expiry.
- 2You open the link. You must be signed in to Pressbotics — an upload link is not an open door. The page shows which site the file is for and why.
- 3You drop the file in, or pick it from your device. The page shows progress and a clear success state. There is nothing to copy back.
- 4The agent polls get_media_upload until status is "ready", then passes the returned media_ref as featured_media_ref on the publish call.
Limits
| Value | Notes | |
|---|---|---|
| Accepted types | JPEG, PNG, GIF, WebP, AVIF | Detected from the file's magic bytes, not its extension or declared type. |
| Maximum size | 20 MB | Larger files are rejected before anything is stored. |
| Link lifetime | 60 minutes | After that the page shows an expired state and the agent must create a new link. |
| Unused files | Deleted within 24 hours | An uploaded file that is never used is removed. |
| Used files | Deleted immediately | Once the file reaches WordPress, the buffered copy is deleted. |
| EXIF | Stripped | Camera and GPS metadata is removed from images before storage. |
The accepted type is decided by reading the file's magic bytes. Renaming a text file to photo.jpg does not get it past this — it is rejected with a plain-language reason and nothing is stored.
EXIF, including GPS
Phone photos routinely carry the exact coordinates of someone's home or business. Pressbotics strips camera and GPS metadata from images before storing them, so that data never reaches the media library either.
We are not a media host
The WordPress media library is the destination and the system of record. Anything Pressbotics stores in between is a transit buffer: it moves the bytes from your device to your site and is then deleted. Used files are deleted as soon as WordPress has them; unused ones are deleted within 24 hours. Nothing is kept beyond that window.
What can go wrong
- The link expired — 60 minutes is short on purpose. Ask the agent for a new one; it can create another immediately.
- You opened the link while signed out. Sign in and you are returned to the same upload page.
- You opened someone else's link. It shows as not found. Upload links are scoped to the workspace they were created in.
- The agent published before polling. Wait for status "ready" — a pending upload has no media_ref to pass.