Murals Report API

Overview

  • URL: GET https://api.mural.co/enterprise/v1/reports/murals
  • Function: Lists murals created in your organization.

Use cases

We have grouped use cases into two types: compliance and security, and engagement.

Compliance and Security

Scenario: Company admins need to find outdated content that can be removed or updated.

Solution: Get a listing of murals. Sort the list of rows by archived and/or deleted attributes to remove the murals that are archived or deleted. This retains the active murals.

Scenario: Identify the member responsible for deleting a mural, and the date when it occurred.

Solution: Get a listing of murals. Look for the deletedUserId attribute to identify the user that deleted the mural.

Scenario: Company admins want visibility into murals that have transferred ownership from one member to another.

Solution: Get a listing of murals. Include the details of the muralId, roomId, workspaceId, creatorId and ownerId. Look for instances where creatorId is not the same as ownerId.

Scenario: Company admins wish to track visitor link permissions for members and external collaborators. Visitors can be invited through Visitor Links in the Share Mural modal. Link permissions can be set by the mural owner for inviting members and external collaborators.

If mural link sharing is disabled for a particular mural (for members as well as visitors), members might want to know why the link sharing is off, and could then reach out to the mural owner.

Solution:

Get a list of murals. Focus on the unique muralId, roomId, workspaceId, ownerIdEmail, shareLinkMemberPermissions, shareLinkVisitorPermissions you would like to investigate.

If shareLinkMemberPermissions is set to Off, shareLinkVisitorPermissions is also Off by default.

Request the mural owner to change shareLinkMemberPermissions to Can Edit or View Only. This must be done before link sharing for shareLinkVisitorPermissions can be turned on for Can Edit or View Only.

Engagement

Scenario: Company admins want to see how many guests and members are part of a mural. This is useful for identifying murals with low or high engagement, in order to take appropriate action.

Solution: Get a listing of murals. Sort by memberCount and/or guestCount attributes to identify the murals that have low or high engagement.

Murals Report API Reference

👉

Visit the Murals Report API Reference page to try it out in real-time!

The API Reference includes relevant parameters, attributes, responses, and code examples for Curl, Node, Ruby, JS, and Python.


Did this page help you?