Retrieve content change logs of board items

get

https://api.miro.com/v2/orgs/{org_id}/content-logs/items

Retrieves content changes for board items within your organization. Content changes are actions that users can perform on board items, such as updating a sticky note's text. You can retrieve results for a specific time period. You can also filter results based on the board IDs and the emails of users who created, modified, or deleted a board item. Additionally, results can be paginated for easier viewing and processing.

Required scope

contentlogs:export

Rate limiting

Level 4

Enterprise only

This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Company Admin.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

org_id

string

required

Unique identifier of the organization.

Query Params

board_ids

array of strings

length ≤ 15

List of board IDs for which you want to retrieve the content logs.

board_ids

emails

array of strings

length ≤ 15

Filter content logs based on the list of emails of users who created, modified, or deleted the board item.

emails

from

date-time

required

Filter content logs based on the date and time when the board item was last modified. This is the start date and time for the modified date duration.
Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

date-time

required

Filter content logs based on the date and time when the board item was last modified. This is the end date and time for the modified date duration. Format: UTC, adheres to
ISO 8601, includes a trailing Z offset.

cursor

string

A cursor-paginated method returns a portion of the total set of results based on the limit specified and a cursor that points to the next portion of the results. To retrieve the next portion of the collection, set the cursor parameter equal to the cursor value you received in the response of the previous request.

limit

int32

1 to 1000

Defaults to 1000

The maximum number of results to return per call. If the number of logs in the response is greater than the limit specified, the response returns the cursor parameter with a value.

sorting

string

enum

Defaults to asc

Sort order in which you want to view the result set based on the modified date. To sort by an ascending modified date, specify asc. To sort by a descending modified date, specify desc.

Allowed:

Responses

200Response from the API that includes content logs of board items such as data, size of the data list, pagination cursor, and pagination limit.

400Malformed request

401Invalid authentication credentials

403Invalid access

404Not found

429Too many requests