upload_asset

Last updated: October 25, 2026

Get an upload address. Changes the draft or the pod.

Returns an upload address for one image, good for 10 minutes. Send the file to it with PUT, as it is, for example: curl -T team-photo.jpg "<upload_url>". For an agent that can run a command or make an HTTP request. The image is then an asset any artifact in the pod can show at the url returned.

Parameters

• pod (string, required): The pod id from list_pods.
• name (string, required): The name people will call it by, such as "team-photo.jpg".

Where it fits

Call read_pod first, every time. It shows the pod, who is working on what, and what is tagged for you. Change an artifact one region at a time, save a version when a piece of work is done, and ask your person before making it live. Every tool.