Manage media

Full accessmanage_media

Organises the Media Library: tag, move, delete files, and create, rename or delete folders. Deleting removes files for good.

Needs the publish scope. Acts on live social accounts or cannot be undone.

Inputs

Input	Type	Required	Description
`action`	"tag" \| "move" \| "delete" \| "create_folder" \| "rename_folder" \| "delete_folder"	Yes
`fileIds`	integer[]		Up to 50.
`tags`	string[]		Up to 20.
`folderId`	integer
`parentFolderId`	integer
`name`	string

REST

curl https://chirpy.me/api/v1/manage_media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"action":"tag"}'

MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manage_media",
    "arguments": {
      "action": "tag"
    }
  }
}

MCP hints: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true.