HomeTutorialsAPI ReferenceStatus
API Reference

Edit Asset with AI

post
https://{APP_DOMAIN}/api/3.2/assets//edit

Edits an existing image asset using the prompt as guidance. Works on any image asset — AI-generated, manually uploaded, or URL-imported. The original image is sent to OpenAI as a reference and the result replaces the asset's bytes in place; the asset id and path stay intact. Keywords default to AI-extracted tags from the new prompt unless the caller provides their own.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the image asset to edit

Body Params

Body Params (mirrors POST /assets/generate)

string
required
string
enum
Allowed:
string
enum
Allowed:
string
tag_ids
array of integers
tag_ids
integer

Optional AuthorInfo id whose agent_instructions are woven into the prompt as a persona

boolean

Set true to accept AI billing terms before queueing this billable AI request

string

Optional surrounding content this image will accompany. Folded in as background and included in SEO keyword extraction. Max 32000 chars.

Responses
202

The image edit task has been queued

400

Invalid params or the AI service rejected the prompt

401

AI integration is not configured

403

AI billing terms must be accepted before generation

404

Asset not found

422

Validation failed or asset is not an image

429

AI rate limit hit

500

AI generation failed or asset persistence failed

Updated 22 days ago

Language
Credentials
Bearer
JWT
URL
LoadingLoading…

Updated 22 days ago