Move Media

Move one or many media to a different folder and optionally to a specific subfolder. Max 100 media per request, and max 10 requests in 5 minutes. Note: this is a different rate limit than applies to the rest of the api!

If a subfolder_id is provided, media will be moved to that subfolder. The subfolder must belong to the specified folder.

Returns a Background Job as the move is async.

Requires api token with one of the following permissions

Read, update & delete anything
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
hashed_ids
array of strings
required

An array of the media hashed IDs to be moved.

hashed_ids*
string
required

The hashed ID of the folder where you want the media moved.

string

Optional. The hashed ID of the subfolder where you want the media moved. If not provided, media will be moved to the folder's default subfolder. The subfolder must belong to the specified folder.

Headers
string
required
Defaults to 2026-03
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json