MCPDocumentationResourcesMarketplaceCommunity
API Reference
Build your app

Get AI interaction logs (Beta)

get
https://api.miro.com/v2/orgs//ai-interaction-logs

Retrieves AI interaction logs for your organization. AI interaction logs capture user interactions with AI features in Miro. You can retrieve results for a specific time period. You can also filter results based on object IDs and the emails of users who interacted with AI features. Additionally, results can be paginated for easier viewing and processing.

Required scope

aiinteractionlogs:read

Rate limiting

Level 4

Enterprise Guard only

This API is available only for Enterprise plan users with the Enterprise Guard add-on.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique identifier of the organization.

Query Params
object_ids
array of strings
length ≤ 15

List of object IDs used to retrieve AI interaction logs.
Currently, supported object types include board IDs and organization IDs.
You can obtain object IDs from the response of this endpoint (the object.id field),
from other Platform API endpoints (for example, Get boards API),
or from Miro UI URLs (board ID and organization ID from the URLs).

object_ids
emails
array of strings
length ≤ 15

Filters AI interaction logs using a list of user emails. Only AI interactions associated with the provided emails will be included in the response.

emails
date-time
required

Start date and time of the time range used to filter AI interaction logs. Only interactions that were stored within the specified from - to time range are returned.
Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

date-time
required

End date and time of the time range used to filter AI interaction logs. Only interactions that were stored within the specified from - to time range are returned.
Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

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.

int32
1 to 100
Defaults to 100

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.

string
enum
Defaults to asc

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

Allowed:
Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?