wp_upload_image tool reference for media workflows
Writeuploads an image from base64 or a data URL and creates a media attachment.
Description
uploads an image from base64 or a data URL and creates a media attachment.
What it is for
- Saving AI-generated images.
- Integrating workflows where the image arrives as base64.
Example use case
storing a generated asset.
Sample prompt
Upload this base64 image to the media library and title it Summer Campaign Hero.
Sample response
{
"tool": "wp_upload_image",
"status": "ok",
"updated": true
}
What does wp_upload_image do?
uploads an image from base64 or a data URL and creates a media attachment.
Does wp_upload_image modify the media library?
Yes. It can create, update, or delete media assets depending on the arguments.
Which capability is commonly required?
It usually runs under controls compatible with upload_files and the active MCP profile.
How should wp_upload_image be used safely?
Confirm target assets, review uploads before publication, and keep rollback-friendly workflows where possible.
What dependency should be confirmed first?
Base64 or data URL payload provided