Transfer Media

Transfer all media owned by one user to another

post

The endpoint transfers all not shared media objects owned by the user to a new owner. We transfer the media objects themselves, all perspectives stored in the "My Library" and in custom collections.

Authorizations

UserSession

AuthorizationstringRequired

Body

application/json

from_user_idintegerRequired

to_user_idintegerRequired

Responses

200

The media has been successfully transferred to the target user.

application/json

not_transferred_perspective_idsstring[]Optional

not_transferred_collection_idsinteger[]Optional

400

If users are not found with the provided ids, the endpoint returns HTTP 400.

401

Authorization information is missing or invalid.

403

If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.

422

Invalid user_id is provided.

post/transfer_media

HTTPcURLJavaScriptPython

POST /api/public/v1/transfer_media HTTP/1.1
Host: tw.instructuremedia.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "from_user_id": 1,
  "to_user_id": 1
}

{
  "not_transferred_perspective_ids": [
    "text"
  ],
  "not_transferred_collection_ids": [
    1
  ]
}