Action

Run an upscale, variation, or another subsequent action on an existing Midjourney task.

The Action API uses a buttons[].customId value returned in task details to run subsequent actions such as upscaling, creating variations, zooming, or panning. Do not construct a customId yourself; always use the value for the intended button in the task response.

POST/mj/submit/action

Use a customId from the task's returned buttons to run a subsequent action such as upscaling, creating a variation, zooming, or panning.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

Action Parameters.

TypeScript Definitions

Use the request body type in TypeScript.

accountFilter?

Optional account filters.

notifyHook?string

Valid callback URL invoked when the task completes. Pass an empty string to use the platform-configured default callback URL.

state?string

Caller-provided state value used to correlate requests with callbacks.

chooseSameChannel?boolean

Whether to use an account from the channel associated with the original task.

Defaultfalse

customId*string

Action identifier taken from the task's buttons[].customId value.

Length1 <= length

taskId*string

ID of the task on which to run the action.

Length1 <= length

Response Body

`application/json`

curl -X POST "https://example.com/mj/submit/action" \  -H "Content-Type: application/json" \  -d '{    "chooseSameChannel": true,    "customId": "MJ::JOB::upsample::1::82c51c9d-bc33-4c07-a471-36c3dcb1a6f0",    "taskId": "1728781324658687",    "accountFilter": {      "channelId": "",      "instanceId": "",      "modes": [],      "remark": "",      "remix": true,      "remixAutoConsidered": true    },    "notifyHook": "",    "state": "request-004"  }'

{
  "code": 1,
  "description": "Submitted successfully",
  "properties": {},
  "result": 1320098173412546
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`