photoshop_save_selection
Save the active pixel selection as a new alpha channel to preserve it for later reload or batch workflows. Requires an active pixel selection.
Instructions
Save the active pixel selection to a new alpha channel.
Use when: preserving a selection for later reload or batch workflows. Do NOT use when: no selection exists — create one first.
Returns: JSON { ok, summary, details: { channel_name, context } }. Preconditions: active document and active pixel selection. Side effects: adds alpha channel.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"document_id": "<document_id>"
},
"name": "photoshop_save_selection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document_id | Yes | Photoshop document id from photoshop_get_state / photoshop_list_documents. Send null or 0 to use the active document. A positive number activates that document before the tool runs. When no document is open, a stale id does not block the call. | |
| channel_name | No | Optional name for the new alpha channel (auto-generated if omitted) |