Skip to main content

Transfer Report Ownership

Zuora

Transfer Report Ownership

Transfer Report Ownership API primarily helps reassign ownership of reports created by inactive users. Reports that have not been shard among other users become hard to manage in such cases. To mitigate this issue, the Transfer Report Ownership API allows you to transfer the ownership of reports from one user to another.

This API supports transfer by both ReportNames and ReportIds:

  • The user associated with the username & password listed in the HTTP headers must have Zuora Reporting Administrator role.
  • If you do not know what userId of new owner:
    • Navigate to the Administration > Manage Users > Click the new owner's name.
    • A URL haveing the UrseId is generated. For example, https://{zuora endpoint}/apps/UserLogin.do?method=view&id=4c85f2b42ba949569a5d15e77c6b9742&flag=1&menu=Z-Admin

The value of the "id" in the URL is the required userId. 

Request:

curl -X POST https://zconnectsandbox.zuora.com/api/rest/v1/reports/transfer-ownership \ 
-H 'Content-Type: application/json' \ 
-H "apiAccessKeyId:{username}" \ 
-H "apiSecretAccessKey:{password}" \ 
-d '{ "reportNames": 
        [ "Report1",     
          "Report2" ],   
            "newOwnerUserId": "
                {new user id}" 
     }' 
 curl -X POST https://zconnectsandbox.zuora.com/api/rest/v1/reports/transfer-ownership \ 
 -H 'Content-Type: application/json' \ 
 -H "apiAccessKeyId:{username}" \ 
 -H "apiSecretAccessKey:{password}" \ 
 -d '{ "reportIds": 
        [ "Id1",
          "Id2" ],  
             "newOwnerUserId": 
               "{new user id}" 
     }'

Response:

{"success" : true,   
 "response" : "Transfer ownership successfully" } 

The new user's transferred reports will be under the folder:

  • Transferred Reports YYYY-mm-DD

 Screenshot 2025-04-11 at 15.37.16.png