Skip to main content

Transfer ownership

POST https://api.rollstack.com/public/v1/reports/{id}/transfer-ownership

Makes a member of the organization the owner of a report. Only its owner may, and keeps edit access.

Requires the slide_decks:write scope.

Operation ID: transferReportOwnership.

Path parameters

  • id (string, required): The report to act on, by its id from listReports or createReport. Only reports whose type is SlideDeck work here: another type, such as a Google Slides presentation, returns 400. You can also copy it from the report's link in Rollstack: it's the part right after /slides/.

Headers

  • Idempotency-Key (string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.

Request body, required

application/json

  • newOwnerId (integer, required): The member who becomes the report's owner, by user id: their id in listMembers, or their userId in the report's sharedWith. They must be an active member of the organization other than you. The previous owner keeps edit access to the report, and the new owner is notified. Example: 1042.

Response 204

Success, no content