content_media_create_upload_url

Tool

content_media_create_upload_url

Get a time-limited signed URL to PUT a file straight into the product bucket.

Get a time-limited signed URL to PUT a file straight into the product bucket. Creates a pending asset; call content_media_finalize once the upload finishes.

Behavior

HTTP: POST /content/media/upload-url

Arguments

Name	Type	Required	Description
filename	string	—	Name to store the file under, for display purposes.
contentType	string	•	The media type the app will PUT, e.g. video/mp4. Must be image/* or video/*.

Response

Field	Type	Always	Description
asset	object	•	The pending asset row. It turns ready on finalize.
expiresAt	string	•	ISO-8601 time after which the upload URL stops working.
uploadUrl	string	•	Time-limited signed PUT URL. Upload the bytes to it, then call the finalize tool.
contentType	string	•	The Content-Type header the PUT must send — the signature covers it.

Try it

Get a time-limited signed URL to PUT a file straight into the product bucket.

When to use

Get a time-limited signed URL to PUT a file straight into the product bucket. Creates a pending asset; call content_media_finalize once the upload finishes.

Example

Ask your agent something like this:

Get a time-limited signed URL to PUT a file straight into the product bucket.

The agent will invoke content_media_create_upload_url with these arguments:

{
  "contentType": "<contentType>"
}