Update the AI image-edit configuration

PATCH

/admin/system/aiedit

• Local development behind nginx (port 8088 by default)

Names the operator-registered MCP server (see /admin/ai/mcp-clients) the aiedit dispatcher routes calls to. The named server must already be registered + enabled + have the “img2img” tool whitelisted before the runtime endpoint will succeed.

Authorizations

• cookieAuth
• bearerAuth

Request Body ^required

AI image-edit subsystem configuration. One field today; the typed surface (per-op MCP server overrides, default workflow selection, …) may expand later.

object

image_edit_server

Name of an operator-registered MCP server (see /admin/ai/mcp-clients) the aiedit dispatcher routes image-edit calls to. Must match a row in mcp_server_registration.name exactly. Empty = feature disabled (viewer hides the Generate variation button + the runtime endpoint returns 409).

string

Responses

200

Updated image-edit config

AI image-edit subsystem configuration. One field today; the typed surface (per-op MCP server overrides, default workflow selection, …) may expand later.

object

image_edit_server

Name of an operator-registered MCP server (see /admin/ai/mcp-clients) the aiedit dispatcher routes image-edit calls to. Must match a row in mcp_server_registration.name exactly. Empty = feature disabled (viewer hides the Generate variation button + the runtime endpoint returns 409).

string

400

Malformed request

object

error

required

Human-readable error summary

string

Example

the request could not be completed

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed