KosmoKrator

productivity

Miro Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Miro KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.miro.*. Use lua_read_doc("integrations.miro") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Miro workflow without starting an interactive agent session.

Inline Lua call
kosmo integrations:lua --eval 'dump(app.integrations.miro.revoke_token({}))' --json
Read Lua docs headlessly
kosmo integrations:lua --eval 'print(docs.read("miro"))' --json
kosmo integrations:lua --eval 'print(docs.read("miro.revoke_token"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua
local miro = app.integrations.miro
local result = miro.revoke_token({})

dump(result)
Run the workflow
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.miro, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.miro.default.* or app.integrations.miro.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Miro, use the narrower mcp:lua command.

MCP Lua command
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Miro Lua Tools

Namespace: miro

Generated from the official Miro Developer Platform OpenAPI spec in miroapp/api-clients. Configure access_token with a Miro OAuth access token.

Coverage

  • Paths: 114
  • Tools: 197
  • Read tools: 85
  • Write tools: 112
  • Multipart upload tools: 5

Usage Notes

  • Path and query parameters use snake_case tool keys and are sent with official API names.
  • JSON and application/scim+json request payloads go in body.
  • Multipart upload tools also use body; each field can be a scalar value or a prebuilt multipart part object with name and contents.
  • Some official path parameter names include generated suffixes from the Miro spec. Those names are preserved in snake_case so requests remain mechanically faithful to the source.

Example Lua

local boards = miro.miro_get_boards({ limit = 25 })
local note = miro.miro_create_sticky_note_item({ board_id = "board-id", body = { data = { content = "Follow up" } } })
Raw agent markdown
# Miro Lua Tools

Namespace: `miro`

Generated from the official Miro Developer Platform OpenAPI spec in `miroapp/api-clients`. Configure `access_token` with a Miro OAuth access token.

## Coverage

- Paths: 114
- Tools: 197
- Read tools: 85
- Write tools: 112
- Multipart upload tools: 5

## Usage Notes

- Path and query parameters use snake_case tool keys and are sent with official API names.
- JSON and `application/scim+json` request payloads go in `body`.
- Multipart upload tools also use `body`; each field can be a scalar value or a prebuilt multipart part object with `name` and `contents`.
- Some official path parameter names include generated suffixes from the Miro spec. Those names are preserved in snake_case so requests remain mechanically faithful to the source.

## Example Lua

```lua
local boards = miro.miro_get_boards({ limit = 25 })
local note = miro.miro_create_sticky_note_item({ board_id = "board-id", body = { data = { content = "Follow up" } } })
```
Metadata-derived Lua example
local result = app.integrations.miro.revoke_token({})
print(result)

Functions

revoke_token Write

Please use the new revoke endpoint /v2/oauth/revoke. This endpoint is considered vulnerable and deprecated due to access token passed publicly in the URL. Revoke the current access token. Revoking an access token means that the access token will no longer work

Lua path
app.integrations.miro.revoke_token
Full name
miro.miro_revoke_token
ParameterTypeRequiredDescription
No parameters.
token_info Read

Get information about an access token, such as the token type, scopes, team, user, token creation date and time, and the user who created the token. Official Miro endpoint: GET /v1/oauth-token.

Lua path
app.integrations.miro.token_info
Full name
miro.miro_token_info
ParameterTypeRequiredDescription
No parameters.
enterprise_get_ai_interaction_logs Read

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 intera

Lua path
app.integrations.miro.enterprise_get_ai_interaction_logs
Full name
miro.miro_enterprise_get_ai_interaction_logs
ParameterTypeRequiredDescription
No parameters.
enterprise_get_audit_logs Read

Retrieves a page of audit events from the last 90 days. If you want to retrieve data that is older than 90 days, you can use the CSV export feature. Required scope auditlogs:read Rate limiting Level 2 Official Miro endpoint: GET /v2/audit/logs.

Lua path
app.integrations.miro.enterprise_get_audit_logs
Full name
miro.miro_enterprise_get_audit_logs
ParameterTypeRequiredDescription
No parameters.
enterprise_dataclassification_organization_settings_get Read

Retrieves board classification settings for an existing organization. Required scope organizations:read Rate limiting Level 2 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

Lua path
app.integrations.miro.enterprise_dataclassification_organization_settings_get
Full name
miro.miro_enterprise_dataclassification_organization_settings_get
ParameterTypeRequiredDescription
No parameters.
enterprise_dataclassification_team_boards_bulk Write

Updates board classification for not-classified only or all boards in an existing team. Required scope boards:write 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

Lua path
app.integrations.miro.enterprise_dataclassification_team_boards_bulk
Full name
miro.miro_enterprise_dataclassification_team_boards_bulk
ParameterTypeRequiredDescription
No parameters.
enterprise_dataclassification_team_settings_get Read

Retrieves board classification settings for an existing team. Required scope organizations:teams:read Rate limiting Level 2 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 A

Lua path
app.integrations.miro.enterprise_dataclassification_team_settings_get
Full name
miro.miro_enterprise_dataclassification_team_settings_get
ParameterTypeRequiredDescription
No parameters.
enterprise_dataclassification_team_settings_set Write

Updates board classification settings for an existing team. Required scope organizations:teams:write Rate limiting Level 2 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 Ad

Lua path
app.integrations.miro.enterprise_dataclassification_team_settings_set
Full name
miro.miro_enterprise_dataclassification_team_settings_set
ParameterTypeRequiredDescription
No parameters.
enterprise_dataclassification_board_get Read

Retrieves board classification for a board. Required scope boards:read Rate limiting Level 2 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. You can request temporary

Lua path
app.integrations.miro.enterprise_dataclassification_board_get
Full name
miro.miro_enterprise_dataclassification_board_get
ParameterTypeRequiredDescription
No parameters.
enterprise_dataclassification_board_set Write

Updates board classification for an existing board. Required scope boards:write Rate limiting Level 2 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. You can request

Lua path
app.integrations.miro.enterprise_dataclassification_board_set
Full name
miro.miro_enterprise_dataclassification_board_set
ParameterTypeRequiredDescription
No parameters.
create_doc_format_item Write

Adds a doc format item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/docs.

Lua path
app.integrations.miro.create_doc_format_item
Full name
miro.miro_create_doc_format_item
ParameterTypeRequiredDescription
No parameters.
get_doc_format_item Read

Retrieves information for a specific doc format item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/docs/{item_id}.

Lua path
app.integrations.miro.get_doc_format_item
Full name
miro.miro_get_doc_format_item
ParameterTypeRequiredDescription
No parameters.
delete_doc_format_item Write

Deletes a doc format item from the board Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/docs/{item_id}.

Lua path
app.integrations.miro.delete_doc_format_item
Full name
miro.miro_delete_doc_format_item
ParameterTypeRequiredDescription
No parameters.
get_all_cases Read

Retrieves the list of eDiscovery cases in an organization. Required scope organization:cases:management Rate limiting Level 4 Enterprise Guard only This API is available only for Enterprise plan users with the Enterprise Guard add-on. You can only use this end

Lua path
app.integrations.miro.get_all_cases
Full name
miro.miro_get_all_cases
ParameterTypeRequiredDescription
No parameters.
create_case Write

Creating a case for legal hold is the first critical step in the eDiscovery process when litigation or an investigation is anticipated. One of the purposes of creating a case is that it acts as a container that allows admins to group multiple legal holds under

Lua path
app.integrations.miro.create_case
Full name
miro.miro_create_case
ParameterTypeRequiredDescription
No parameters.
delete_case Write

Closing a case is the final stage in the eDiscovery process, marking the conclusion of a legal matter or investigation. You must ensure that all associated legal holds within the case are closed before closing the case. Closing a case will permanently delete i

Lua path
app.integrations.miro.delete_case
Full name
miro.miro_delete_case
ParameterTypeRequiredDescription
No parameters.
get_case Read

Retrieves information about a case in an organization. Required scope organization:cases:management Rate limiting Level 3 Enterprise Guard only This API is available only for Enterprise plan users with the Enterprise Guard add-on. You can only use this endpoin

Lua path
app.integrations.miro.get_case
Full name
miro.miro_get_case
ParameterTypeRequiredDescription
No parameters.
edit_case Write

Editing a case allows eDiscovery Admins to keep case details accurate and aligned with the evolving scope of a legal matter. As investigations progress, it may be necessary to update the case name or description to reflect changes in focus, terminology, or int

Lua path
app.integrations.miro.edit_case
Full name
miro.miro_edit_case
ParameterTypeRequiredDescription
No parameters.
enterprise_create_board_export Write

Creates an export job for one or more boards. Required scope boards: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 and eDiscovery is enab

Lua path
app.integrations.miro.enterprise_create_board_export
Full name
miro.miro_enterprise_create_board_export
ParameterTypeRequiredDescription
No parameters.
enterprise_board_export_jobs Read

Retrieves the list of board export jobs based on the filters provided in the request. Required scope boards: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 o

Lua path
app.integrations.miro.enterprise_board_export_jobs
Full name
miro.miro_enterprise_board_export_jobs
ParameterTypeRequiredDescription
No parameters.
enterprise_board_export_job_status Read

Retrieves the status of the board export job. Required scope boards: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 and eDiscovery is enab

Lua path
app.integrations.miro.enterprise_board_export_job_status
Full name
miro.miro_enterprise_board_export_job_status
ParameterTypeRequiredDescription
No parameters.
enterprise_board_export_job_results Read

Retrieves the result of the board export job. The response provides more information about the board export job, such as the S3 link to the files created. Required scope boards:export Rate limiting Level 4 Enterprise only This API is available only for Enterpr

Lua path
app.integrations.miro.enterprise_board_export_job_results
Full name
miro.miro_enterprise_board_export_job_results
ParameterTypeRequiredDescription
No parameters.
enterprise_update_board_export_job Write

Updates the status of the board export job. Currently, only the cancellation of an ongoing export job is supported. Required scope boards:export Rate limiting Level 4 Enterprise only This API is available only for Enterprise plan users. You can only use this e

Lua path
app.integrations.miro.enterprise_update_board_export_job
Full name
miro.miro_enterprise_update_board_export_job
ParameterTypeRequiredDescription
No parameters.
enterprise_board_export_job_tasks Read

Retrieves the list of tasks for the board export job. Required scope boards: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 and eDiscovery

Lua path
app.integrations.miro.enterprise_board_export_job_tasks
Full name
miro.miro_enterprise_board_export_job_tasks
ParameterTypeRequiredDescription
No parameters.
enterprise_board_content_item_logs_fetch Read

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

Lua path
app.integrations.miro.enterprise_board_content_item_logs_fetch
Full name
miro.miro_enterprise_board_content_item_logs_fetch
ParameterTypeRequiredDescription
No parameters.
enterprise_post_user_sessions_reset Write

Reset all sessions of a user. Admins can now take immediate action to restrict user access to company data in case of security concerns. Calling this API ends all active Miro sessions across devices for a particular user, requiring the user to sign in again. T

Lua path
app.integrations.miro.enterprise_post_user_sessions_reset
Full name
miro.miro_enterprise_post_user_sessions_reset
ParameterTypeRequiredDescription
No parameters.
list_users Read

Retrieves the list of users in your organization. Note: The API returns users that are members in the organization, it does not return users that are added in the organization as guests. Official Miro endpoint: GET /Users.

Lua path
app.integrations.miro.list_users
Full name
miro.miro_list_users
ParameterTypeRequiredDescription
No parameters.
create_user Write

Creates a new user in the organization. Note: All newly provisioned users are added to the default team. Official Miro endpoint: POST /Users.

Lua path
app.integrations.miro.create_user
Full name
miro.miro_create_user
ParameterTypeRequiredDescription
No parameters.
get_user Read

Retrieves a single user resource. Note: Returns only users that are members in the organization. It does not return users that are added in the organization as guests. Official Miro endpoint: GET /Users/{id}.

Lua path
app.integrations.miro.get_user
Full name
miro.miro_get_user
ParameterTypeRequiredDescription
No parameters.
replace_user Write

Updates an existing user resource. This is the easiest way to replace user information. If the user is deactivated, userName, userType, and roles.value cannot be updated. emails.value, emails.display, emails.primary get ignored and do not return any error. Not

Lua path
app.integrations.miro.replace_user
Full name
miro.miro_replace_user
ParameterTypeRequiredDescription
No parameters.
patch_user Write

Updates an existing user resource, overwriting values for specified attributes. Attributes that are not provided will remain unchanged. PATCH operation only updates the fields provided. Note: If the user is not a member in the organization, they cannot be upda

Lua path
app.integrations.miro.patch_user
Full name
miro.miro_patch_user
ParameterTypeRequiredDescription
No parameters.
delete_user Write

Deletes a single user from the organization. Note: A user who is the last admin in the team or the last admin in the organization cannot be deleted. User must be a member in the organization to be deleted. Users that have guest role in the organization cannot

Lua path
app.integrations.miro.delete_user
Full name
miro.miro_delete_user
ParameterTypeRequiredDescription
No parameters.
list_groups Read

Retrieves the list of groups (teams) in the organization. Note: Along with groups (teams), the users that are part of those groups (teams) are also retrieved. Only users that have member role in the organization are fetched. Official Miro endpoint: GET /Group

Lua path
app.integrations.miro.list_groups
Full name
miro.miro_list_groups
ParameterTypeRequiredDescription
No parameters.
get_group Read

Retrieves a single Group resource. Note: Along with groups (teams), the users that are part of those groups (teams) are also retrieved. Only users that have member role in the organization are fetched. Official Miro endpoint: GET /Groups/{id}.

Lua path
app.integrations.miro.get_group
Full name
miro.miro_get_group
ParameterTypeRequiredDescription
No parameters.
patch_group Write

Updates an existing group resource, i.e. a team, overwriting values for specified attributes. Patch operation for group can be used to add, remove, or replace team members and to update the display name of the group (team). To add a user to the group (team), u

Lua path
app.integrations.miro.patch_group
Full name
miro.miro_patch_group
ParameterTypeRequiredDescription
No parameters.
list_service_provider_configs Read

Retrieve supported operations and SCIM API basic configuration. Official Miro endpoint: GET /ServiceProviderConfig.

Lua path
app.integrations.miro.list_service_provider_configs
Full name
miro.miro_list_service_provider_configs
ParameterTypeRequiredDescription
No parameters.
list_resource_types Read

Retrieve information about which SCIM resources are supported. Currently, Miro supports Users and Groups as Resource Types. Official Miro endpoint: GET /ResourceTypes.

Lua path
app.integrations.miro.list_resource_types
Full name
miro.miro_list_resource_types
ParameterTypeRequiredDescription
No parameters.
get_resource_type Read

Retrieve metadata for the available resource types (User and Group) that are supported. Official Miro endpoint: GET /ResourceTypes/{resource}.

Lua path
app.integrations.miro.get_resource_type
Full name
miro.miro_get_resource_type
ParameterTypeRequiredDescription
No parameters.
list_schemas Read

Retrieve metadata about Users, Groups, and extension attributes that are currently supported. Official Miro endpoint: GET /Schemas.

Lua path
app.integrations.miro.list_schemas
Full name
miro.miro_list_schemas
ParameterTypeRequiredDescription
No parameters.
get_schema Read

Retrieve information about how users, groups, and enterprise-user attributes URIs that are formatted. Official Miro endpoint: GET /Schemas/{uri}.

Lua path
app.integrations.miro.get_schema
Full name
miro.miro_get_schema
ParameterTypeRequiredDescription
No parameters.
enterprise_get_organization Read

Retrieves organization information. Required scope organizations:read Rate limiting Level 3 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. You can request temporary

Lua path
app.integrations.miro.enterprise_get_organization
Full name
miro.miro_enterprise_get_organization
ParameterTypeRequiredDescription
No parameters.
enterprise_get_organization_members Read

Retrieves organization members based on the organization ID and the cursor, or based on the user emails provided in the request. Required scope organizations:read Rate limiting Level 3 Enterprise only This API is available only for Enterprise plan users. You c

Lua path
app.integrations.miro.enterprise_get_organization_members
Full name
miro.miro_enterprise_get_organization_members
ParameterTypeRequiredDescription
No parameters.
enterprise_get_organization_member Read

Retrieves organization member information for an existing organization. Required scope organizations:read Rate limiting Level 3 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Compa

Lua path
app.integrations.miro.enterprise_get_organization_member
Full name
miro.miro_enterprise_get_organization_member
ParameterTypeRequiredDescription
No parameters.
create_board Write

Creates a board with the specified name and sharing policies. Note You can only create up to 3 team boards with the free plan. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: POST /v2/boards.

Lua path
app.integrations.miro.create_board
Full name
miro.miro_create_board
ParameterTypeRequiredDescription
No parameters.
get_boards Read

Retrieves a list of boards accessible to the user associated with the provided access token. This endpoint supports filtering and sorting through URL query parameters. Customize the response by specifying `team_id`, `project_id`, or other query parameters. Fil

Lua path
app.integrations.miro.get_boards
Full name
miro.miro_get_boards
ParameterTypeRequiredDescription
No parameters.
copy_board Write

Creates a copy of an existing board. You can also update the name, description, sharing policy, and permissions policy for the new board in the request body. Required scope boards:write Rate limiting Level 4 Official Miro endpoint: PUT /v2/boards.

Lua path
app.integrations.miro.copy_board
Full name
miro.miro_copy_board
ParameterTypeRequiredDescription
No parameters.
get_specific_board Read

Retrieves information about a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}.

Lua path
app.integrations.miro.get_specific_board
Full name
miro.miro_get_specific_board
ParameterTypeRequiredDescription
No parameters.
update_board Write

Updates a specific board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}.

Lua path
app.integrations.miro.update_board
Full name
miro.miro_update_board
ParameterTypeRequiredDescription
No parameters.
delete_board Write

Deletes a board. Deleted boards go to Trash (on paid plans) and can be restored via UI within 90 days after deletion. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}.

Lua path
app.integrations.miro.delete_board
Full name
miro.miro_delete_board
ParameterTypeRequiredDescription
No parameters.
create_app_card_item Write

Adds an app card item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/app_cards.

Lua path
app.integrations.miro.create_app_card_item
Full name
miro.miro_create_app_card_item
ParameterTypeRequiredDescription
No parameters.
get_app_card_item Read

Retrieves information for a specific app card item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/app_cards/{item_id}.

Lua path
app.integrations.miro.get_app_card_item
Full name
miro.miro_get_app_card_item
ParameterTypeRequiredDescription
No parameters.
update_app_card_item Write

Updates an app card item on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/app_cards/{item_id}.

Lua path
app.integrations.miro.update_app_card_item
Full name
miro.miro_update_app_card_item
ParameterTypeRequiredDescription
No parameters.
delete_app_card_item Write

Deletes an app card item from a board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/app_cards/{item_id}.

Lua path
app.integrations.miro.delete_app_card_item
Full name
miro.miro_delete_app_card_item
ParameterTypeRequiredDescription
No parameters.
create_card_item Write

Adds a card item to a board Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/cards.

Lua path
app.integrations.miro.create_card_item
Full name
miro.miro_create_card_item
ParameterTypeRequiredDescription
No parameters.
get_card_item Read

Retrieves information for a specific card item on a board Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/cards/{item_id}.

Lua path
app.integrations.miro.get_card_item
Full name
miro.miro_get_card_item
ParameterTypeRequiredDescription
No parameters.
update_card_item Write

Updates a card item on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/cards/{item_id}.

Lua path
app.integrations.miro.update_card_item
Full name
miro.miro_update_card_item
ParameterTypeRequiredDescription
No parameters.
delete_card_item Write

Deletes a card item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/cards/{item_id}.

Lua path
app.integrations.miro.delete_card_item
Full name
miro.miro_delete_card_item
ParameterTypeRequiredDescription
No parameters.
create_connector Write

Adds a connector to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/connectors.

Lua path
app.integrations.miro.create_connector
Full name
miro.miro_create_connector
ParameterTypeRequiredDescription
No parameters.
get_connectors Read

Retrieves a list of connectors for a specific board. This method returns results using a cursor-based approach. 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

Lua path
app.integrations.miro.get_connectors
Full name
miro.miro_get_connectors
ParameterTypeRequiredDescription
No parameters.
get_connector Read

Retrieves information for a specific connector on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/connectors/{connector_id}.

Lua path
app.integrations.miro.get_connector
Full name
miro.miro_get_connector
ParameterTypeRequiredDescription
No parameters.
update_connector Write

Updates a connector on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/connectors/{connector_id}.

Lua path
app.integrations.miro.update_connector
Full name
miro.miro_update_connector
ParameterTypeRequiredDescription
No parameters.
delete_connector Write

Deletes the specified connector from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/connectors/{connector_id}.

Lua path
app.integrations.miro.delete_connector
Full name
miro.miro_delete_connector
ParameterTypeRequiredDescription
No parameters.
create_document_item_using_url Write

Adds a document item to a board by specifying the URL where the document is hosted. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/documents.

Lua path
app.integrations.miro.create_document_item_using_url
Full name
miro.miro_create_document_item_using_url
ParameterTypeRequiredDescription
No parameters.
get_document_item Read

Retrieves information for a specific document item on a board Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/documents/{item_id}.

Lua path
app.integrations.miro.get_document_item
Full name
miro.miro_get_document_item
ParameterTypeRequiredDescription
No parameters.
update_document_item_using_url Write

Updates a document item on a board Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/documents/{item_id}.

Lua path
app.integrations.miro.update_document_item_using_url
Full name
miro.miro_update_document_item_using_url
ParameterTypeRequiredDescription
No parameters.
delete_document_item Write

Deletes a document item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/documents/{item_id}.

Lua path
app.integrations.miro.delete_document_item
Full name
miro.miro_delete_document_item
ParameterTypeRequiredDescription
No parameters.
create_embed_item Write

Adds an embed item containing external content to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/embeds.

Lua path
app.integrations.miro.create_embed_item
Full name
miro.miro_create_embed_item
ParameterTypeRequiredDescription
No parameters.
get_embed_item Read

Retrieves information for a specific embed item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/embeds/{item_id}.

Lua path
app.integrations.miro.get_embed_item
Full name
miro.miro_get_embed_item
ParameterTypeRequiredDescription
No parameters.
update_embed_item Write

Updates an embed item on a board based on the data properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/embeds/{item_id}.

Lua path
app.integrations.miro.update_embed_item
Full name
miro.miro_update_embed_item
ParameterTypeRequiredDescription
No parameters.
delete_embed_item Write

Deletes an embed item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/embeds/{item_id}.

Lua path
app.integrations.miro.delete_embed_item
Full name
miro.miro_delete_embed_item
ParameterTypeRequiredDescription
No parameters.
create_image_item_using_url Write

Adds an image item to a board by specifying an image URL. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/images.

Lua path
app.integrations.miro.create_image_item_using_url
Full name
miro.miro_create_image_item_using_url
ParameterTypeRequiredDescription
No parameters.
get_image_item Read

Retrieves information for a specific image item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/images/{item_id}.

Lua path
app.integrations.miro.get_image_item
Full name
miro.miro_get_image_item
ParameterTypeRequiredDescription
No parameters.
update_image_item_using_url Write

Updates an image item on a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/images/{item_id}.

Lua path
app.integrations.miro.update_image_item_using_url
Full name
miro.miro_update_image_item_using_url
ParameterTypeRequiredDescription
No parameters.
delete_image_item Write

Deletes an image item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/images/{item_id}.

Lua path
app.integrations.miro.delete_image_item
Full name
miro.miro_delete_image_item
ParameterTypeRequiredDescription
No parameters.
get_items Read

Retrieves a list of items for a specific board. You can retrieve all items on the board, a list of child items inside a parent item, or a list of specific types of items by specifying URL query parameter values. This method returns results using a cursor-based

Lua path
app.integrations.miro.get_items
Full name
miro.miro_get_items
ParameterTypeRequiredDescription
No parameters.
get_specific_item Read

Retrieves information for a specific item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/items/{item_id}.

Lua path
app.integrations.miro.get_specific_item
Full name
miro.miro_get_specific_item
ParameterTypeRequiredDescription
No parameters.
update_item_position_or_parent Write

Updates the position or the parent of an item on a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/items/{item_id}.

Lua path
app.integrations.miro.update_item_position_or_parent
Full name
miro.miro_update_item_position_or_parent
ParameterTypeRequiredDescription
No parameters.
delete_item Write

Deletes an item from a board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/items/{item_id}.

Lua path
app.integrations.miro.delete_item
Full name
miro.miro_delete_item
ParameterTypeRequiredDescription
No parameters.
share_board Write

Shares the board and Invites new members to collaborate on a board by sending an invitation email. Depending on the board's Sharing policy, there might be various scenarios where membership in the team is required in order to share the board with a user. Requi

Lua path
app.integrations.miro.share_board
Full name
miro.miro_share_board
ParameterTypeRequiredDescription
No parameters.
get_board_members Read

Retrieves a pageable list of members for a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/members.

Lua path
app.integrations.miro.get_board_members
Full name
miro.miro_get_board_members
ParameterTypeRequiredDescription
No parameters.
get_specific_board_member Read

Retrieves information for a board member. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/members/{board_member_id}.

Lua path
app.integrations.miro.get_specific_board_member
Full name
miro.miro_get_specific_board_member
ParameterTypeRequiredDescription
No parameters.
update_board_member Write

Updates the role of a board member. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/members/{board_member_id}.

Lua path
app.integrations.miro.update_board_member
Full name
miro.miro_update_board_member
ParameterTypeRequiredDescription
No parameters.
remove_board_member Write

Removes a board member from a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: DELETE /v2/boards/{board_id}/members/{board_member_id}.

Lua path
app.integrations.miro.remove_board_member
Full name
miro.miro_remove_board_member
ParameterTypeRequiredDescription
No parameters.
create_shape_item Write

Adds a shape item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/shapes.

Lua path
app.integrations.miro.create_shape_item
Full name
miro.miro_create_shape_item
ParameterTypeRequiredDescription
No parameters.
get_shape_item Read

Retrieves information for a specific shape item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/shapes/{item_id}.

Lua path
app.integrations.miro.get_shape_item
Full name
miro.miro_get_shape_item
ParameterTypeRequiredDescription
No parameters.
update_shape_item Write

Updates a shape item on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/shapes/{item_id}.

Lua path
app.integrations.miro.update_shape_item
Full name
miro.miro_update_shape_item
ParameterTypeRequiredDescription
No parameters.
delete_shape_item Write

Deletes a shape item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/shapes/{item_id}.

Lua path
app.integrations.miro.delete_shape_item
Full name
miro.miro_delete_shape_item
ParameterTypeRequiredDescription
No parameters.
create_sticky_note_item Write

Adds a sticky note item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/sticky_notes.

Lua path
app.integrations.miro.create_sticky_note_item
Full name
miro.miro_create_sticky_note_item
ParameterTypeRequiredDescription
No parameters.
get_sticky_note_item Read

Retrieves information for a specific sticky note item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/sticky_notes/{item_id}.

Lua path
app.integrations.miro.get_sticky_note_item
Full name
miro.miro_get_sticky_note_item
ParameterTypeRequiredDescription
No parameters.
update_sticky_note_item Write

Updates a sticky note item on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/sticky_notes/{item_id}.

Lua path
app.integrations.miro.update_sticky_note_item
Full name
miro.miro_update_sticky_note_item
ParameterTypeRequiredDescription
No parameters.
delete_sticky_note_item Write

Deletes a sticky note item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/sticky_notes/{item_id}.

Lua path
app.integrations.miro.delete_sticky_note_item
Full name
miro.miro_delete_sticky_note_item
ParameterTypeRequiredDescription
No parameters.
create_text_item Write

Adds a text item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/texts.

Lua path
app.integrations.miro.create_text_item
Full name
miro.miro_create_text_item
ParameterTypeRequiredDescription
No parameters.
get_text_item Read

Retrieves information for a specific text item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/texts/{item_id}.

Lua path
app.integrations.miro.get_text_item
Full name
miro.miro_get_text_item
ParameterTypeRequiredDescription
No parameters.
update_text_item Write

Updates a text item on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/texts/{item_id}.

Lua path
app.integrations.miro.update_text_item
Full name
miro.miro_update_text_item
ParameterTypeRequiredDescription
No parameters.
delete_text_item Write

Deletes a text item from the board Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/texts/{item_id}.

Lua path
app.integrations.miro.delete_text_item
Full name
miro.miro_delete_text_item
ParameterTypeRequiredDescription
No parameters.
create_items Write

Adds different types of items to a board. You can add up to 20 items of the same or different type per create call. For example, you can create 3 shape items, 4 card items, and 5 sticky notes in one create call. The bulk create operation is transactional. If a

Lua path
app.integrations.miro.create_items
Full name
miro.miro_create_items
ParameterTypeRequiredDescription
No parameters.
create_frame_item Write

Adds a frame to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/frames.

Lua path
app.integrations.miro.create_frame_item
Full name
miro.miro_create_frame_item
ParameterTypeRequiredDescription
No parameters.
get_frame_item Read

Retrieves information for a specific frame on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/frames/{item_id}.

Lua path
app.integrations.miro.get_frame_item
Full name
miro.miro_get_frame_item
ParameterTypeRequiredDescription
No parameters.
update_frame_item Write

Updates a frame on a board based on the data, style, or geometry properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id}/frames/{item_id}.

Lua path
app.integrations.miro.update_frame_item
Full name
miro.miro_update_frame_item
ParameterTypeRequiredDescription
No parameters.
delete_frame_item Write

Deletes a frame from a board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/frames/{item_id}.

Lua path
app.integrations.miro.delete_frame_item
Full name
miro.miro_delete_frame_item
ParameterTypeRequiredDescription
No parameters.
get_items_within_frame Read

Retrieves a list of items within a specific frame. A frame is a parent item and all items within a frame are child items. This method returns results using a cursor-based approach. A cursor-paginated method returns a portion of the total set of results based o

Lua path
app.integrations.miro.get_items_within_frame
Full name
miro.miro_get_items_within_frame
ParameterTypeRequiredDescription
No parameters.
create_items_bulk_using_file_from_device Write

Adds different types of items to a board using files from a device. You can add up to 20 items of the same or different type per create call. For example, you can create 5 document items and 5 images in one create call. The bulk create operation is transaction

Lua path
app.integrations.miro.create_items_bulk_using_file_from_device
Full name
miro.miro_create_items_in_bulk_using_file_from_device
ParameterTypeRequiredDescription
No parameters.
get_metrics Read

Returns a list of usage metrics for a specific app for a given time range, grouped by requested time period. This endpoint requires an app management API token. It can be generated in the Your Apps section of Developer Hub. Required scope boards:read Rate limi

Lua path
app.integrations.miro.get_metrics
Full name
miro.miro_get_metrics
ParameterTypeRequiredDescription
No parameters.
get_metrics_total Read

Returns total usage metrics for a specific app since the app was created. This endpoint requires an app management API token. It can be generated in your apps section of Developer Hub. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: G

Lua path
app.integrations.miro.get_metrics_total
Full name
miro.miro_get_metrics_total
ParameterTypeRequiredDescription
No parameters.
get_mindmap_node_experimental Read

Retrieves information for a specific mind map node on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2-experimental/boards/{board_id}/mindmap_nodes/{item_id}.

Lua path
app.integrations.miro.get_mindmap_node_experimental
Full name
miro.miro_get_mindmap_node_experimental
ParameterTypeRequiredDescription
No parameters.
delete_mindmap_node_experimental Write

Deletes a mind map node item and its child nodes from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2-experimental/boards/{board_id}/mindmap_nodes/{item_id}.

Lua path
app.integrations.miro.delete_mindmap_node_experimental
Full name
miro.miro_delete_mindmap_node_experimental
ParameterTypeRequiredDescription
No parameters.
get_mindmap_nodes_experimental Read

Retrieves a list of mind map nodes for a specific board. This method returns results using a cursor-based approach. 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 portio

Lua path
app.integrations.miro.get_mindmap_nodes_experimental
Full name
miro.miro_get_mindmap_nodes_experimental
ParameterTypeRequiredDescription
No parameters.
create_mindmap_nodes_experimental Write

Adds a mind map node to a board. A root node is the starting point of a mind map. A node that is created under a root node is a child node. For information on mind maps, use cases, mind map structure, and more, see the Mind Map Overview page. Required scope bo

Lua path
app.integrations.miro.create_mindmap_nodes_experimental
Full name
miro.miro_create_mindmap_nodes_experimental
ParameterTypeRequiredDescription
No parameters.
get_items_experimental Read

Retrieves a list of items for a specific board. You can retrieve all items on the board, a list of child items inside a parent item, or a list of specific types of items by specifying URL query parameter values. This method returns results using a cursor-based

Lua path
app.integrations.miro.get_items_experimental
Full name
miro.miro_get_items_experimental
ParameterTypeRequiredDescription
No parameters.
get_specific_item_experimental Read

Retrieves information for a specific item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2-experimental/boards/{board_id}/items/{item_id}.

Lua path
app.integrations.miro.get_specific_item_experimental
Full name
miro.miro_get_specific_item_experimental
ParameterTypeRequiredDescription
No parameters.
delete_item_experimental Write

Deletes an item from a board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2-experimental/boards/{board_id}/items/{item_id}.

Lua path
app.integrations.miro.delete_item_experimental
Full name
miro.miro_delete_item_experimental
ParameterTypeRequiredDescription
No parameters.
create_shape_item_flowchart Write

Adds a flowchart shape item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2-experimental/boards/{board_id}/shapes.

Lua path
app.integrations.miro.create_shape_item_flowchart
Full name
miro.miro_create_shape_item_flowchart
ParameterTypeRequiredDescription
No parameters.
get_shape_item_flowchart Read

Retrieves information for a specific shape item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2-experimental/boards/{board_id}/shapes/{item_id}.

Lua path
app.integrations.miro.get_shape_item_flowchart
Full name
miro.miro_get_shape_item_flowchart
ParameterTypeRequiredDescription
No parameters.
update_shape_item_flowchart Write

Updates a flowchart shape item on a board based on the data and style properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2-experimental/boards/{board_id}/shapes/{item_id}.

Lua path
app.integrations.miro.update_shape_item_flowchart
Full name
miro.miro_update_shape_item_flowchart
ParameterTypeRequiredDescription
No parameters.
delete_shape_item_flowchart Write

Deletes a flowchart shape item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2-experimental/boards/{board_id}/shapes/{item_id}.

Lua path
app.integrations.miro.delete_shape_item_flowchart
Full name
miro.miro_delete_shape_item_flowchart
ParameterTypeRequiredDescription
No parameters.
get_code_widget_items Read

Retrieves a list of code widget items for a specific board. This method returns results using a cursor-based approach. 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 por

Lua path
app.integrations.miro.get_code_widget_items
Full name
miro.miro_get_code_widget_items
ParameterTypeRequiredDescription
No parameters.
create_code_widget_item Write

Adds a code widget item to a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2-experimental/boards/{board_id}/code_widgets.

Lua path
app.integrations.miro.create_code_widget_item
Full name
miro.miro_create_code_widget_item
ParameterTypeRequiredDescription
No parameters.
get_code_widget_item Read

Retrieves information for a specific code widget item on a board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2-experimental/boards/{board_id}/code_widgets/{item_id}.

Lua path
app.integrations.miro.get_code_widget_item
Full name
miro.miro_get_code_widget_item
ParameterTypeRequiredDescription
No parameters.
update_code_widget_item Write

Updates a code widget item on a board based on the data properties provided in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2-experimental/boards/{board_id}/code_widgets/{item_id}.

Lua path
app.integrations.miro.update_code_widget_item
Full name
miro.miro_update_code_widget_item
ParameterTypeRequiredDescription
No parameters.
delete_code_widget_item Write

Deletes a code widget item from the board. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2-experimental/boards/{board_id}/code_widgets/{item_id}.

Lua path
app.integrations.miro.delete_code_widget_item
Full name
miro.miro_delete_code_widget_item
ParameterTypeRequiredDescription
No parameters.
move_code_widget_item Write

Updates the position of a code widget item on a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2-experimental/boards/{board_id}/code_widgets/{item_id}/position.

Lua path
app.integrations.miro.move_code_widget_item
Full name
miro.miro_move_code_widget_item
ParameterTypeRequiredDescription
No parameters.
create_document_item_using_file_from_device Write

Adds a document item to a board by selecting file from device. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id_PlatformFileUpload}/documents.

Lua path
app.integrations.miro.create_document_item_using_file_from_device
Full name
miro.miro_create_document_item_using_file_from_device
ParameterTypeRequiredDescription
No parameters.
update_document_item_using_file_from_device Write

Updates a document item on a board by using file from a device. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id_PlatformFileUpload}/documents/{item_id}.

Lua path
app.integrations.miro.update_document_item_using_file_from_device
Full name
miro.miro_update_document_item_using_file_from_device
ParameterTypeRequiredDescription
No parameters.
create_image_item_using_local_file Write

Adds an image item to a board by specifying a file from device. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id_PlatformFileUpload}/images.

Lua path
app.integrations.miro.create_image_item_using_local_file
Full name
miro.miro_create_image_item_using_local_file
ParameterTypeRequiredDescription
No parameters.
update_image_item_using_file_from_device Write

Updates an image item on a board. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PATCH /v2/boards/{board_id_PlatformFileUpload}/images/{item_id}.

Lua path
app.integrations.miro.update_image_item_using_file_from_device
Full name
miro.miro_update_image_item_using_file_from_device
ParameterTypeRequiredDescription
No parameters.
create_group Write

Creates a group of items on a board. The group is created with the items that are passed in the request body. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: POST /v2/boards/{board_id}/groups.

Lua path
app.integrations.miro.create_group
Full name
miro.miro_create_group
ParameterTypeRequiredDescription
No parameters.
get_all_groups Read

Returns all the groups and the items of the respective groups within a specific board. This method returns results using a cursor-based approach. A cursor-paginated method returns a portion of the total set of results based on the limit specified and a cursor

Lua path
app.integrations.miro.get_all_groups
Full name
miro.miro_get_all_groups
ParameterTypeRequiredDescription
No parameters.
get_items_by_group_id Read

Returns a list of items that are a part of any group, within a specific board. This method returns results using a cursor-based approach. A cursor-paginated method returns a portion of the total set of results based on the limit specified and a cursor that poi

Lua path
app.integrations.miro.get_items_by_group_id
Full name
miro.miro_get_items_by_group_id
ParameterTypeRequiredDescription
No parameters.
get_group_by_id Read

Returns a list of items in a specific group. Required scope boards:read Rate limiting Level 2 per item ID Official Miro endpoint: GET /v2/boards/{board_id}/groups/{group_id}.

Lua path
app.integrations.miro.get_group_by_id
Full name
miro.miro_get_group_by_id
ParameterTypeRequiredDescription
No parameters.
un_group Write

Ungroups items from a group. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/groups/{group_id}.

Lua path
app.integrations.miro.un_group
Full name
miro.miro_un_group
ParameterTypeRequiredDescription
No parameters.
update_group Write

This endpoint updates an existing group by replacing it entirely with a new group. When the update is made, the original group is completely replaced, and a new group ID is assigned. Required scope boards:write Rate limiting Level 2 Official Miro endpoint: PU

Lua path
app.integrations.miro.update_group
Full name
miro.miro_update_group
ParameterTypeRequiredDescription
No parameters.
delete_group Write

Deletes a group from a board. All the items in the group are deleted along with the group. Note - this endpoint will delete items which are locked as well. Required scope boards:write Rate limiting Level 3 Official Miro endpoint: DELETE /v2/boards/{board_id}/

Lua path
app.integrations.miro.delete_group
Full name
miro.miro_delete_group
ParameterTypeRequiredDescription
No parameters.
revoke_token_v2 Write

Revoke the current access token. Revoking an access token means that the access token will no longer work. When an access token is revoked, the refresh token is also revoked and no longer valid. This does not uninstall the application for the user. Official M

Lua path
app.integrations.miro.revoke_token_v2
Full name
miro.miro_revoke_token_v2
ParameterTypeRequiredDescription
No parameters.
get_tags_from_item Read

Retrieves all the tags from the specified item. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/items/{item_id}/tags.

Lua path
app.integrations.miro.get_tags_from_item
Full name
miro.miro_get_tags_from_item
ParameterTypeRequiredDescription
No parameters.
create_tag Write

Creates a tag on a board. Required scope boards:write Rate limiting Level 1 Official Miro endpoint: POST /v2/boards/{board_id}/tags.

Lua path
app.integrations.miro.create_tag
Full name
miro.miro_create_tag
ParameterTypeRequiredDescription
No parameters.
get_tags_from_board Read

Retrieves all the tags from the specified board. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/tags.

Lua path
app.integrations.miro.get_tags_from_board
Full name
miro.miro_get_tags_from_board
ParameterTypeRequiredDescription
No parameters.
get_tag Read

Retrieves information for a specific tag. Required scope boards:write Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id}/tags/{tag_id}.

Lua path
app.integrations.miro.get_tag
Full name
miro.miro_get_tag
ParameterTypeRequiredDescription
No parameters.
update_tag Write

Updates a tag based on the data properties provided in the request body. Note: Updates to tags made via the REST API will not be reflected on the board in realtime. To see REST API updates to tags on a board, you need to refresh the board. This applies to the

Lua path
app.integrations.miro.update_tag
Full name
miro.miro_update_tag
ParameterTypeRequiredDescription
No parameters.
delete_tag Write

Deletes the specified tag from the board. The tag is also removed from all cards and sticky notes on the board. Note: Updates to tags made via the REST API will not be reflected on the board in realtime. To see REST API updates to tags on a board, you need to

Lua path
app.integrations.miro.delete_tag
Full name
miro.miro_delete_tag
ParameterTypeRequiredDescription
No parameters.
get_items_by_tag Read

Retrieves all the items that have the specified tag. Required scope boards:read Rate limiting Level 1 Official Miro endpoint: GET /v2/boards/{board_id_PlatformTags}/items.

Lua path
app.integrations.miro.get_items_by_tag
Full name
miro.miro_get_items_by_tag
ParameterTypeRequiredDescription
No parameters.
attach_tag_item Write

Attach an existing tag to the specified item. Card and sticky note items can have up to 8 tags. Note: Updates to tags made via the REST API will not be reflected on the board in realtime. To see REST API updates to tags on a board, you need to refresh the boar

Lua path
app.integrations.miro.attach_tag_item
Full name
miro.miro_attach_tag_to_item
ParameterTypeRequiredDescription
No parameters.
remove_tag_from_item Write

Removes the specified tag from the specified item. The tag still exists on the board. Note: Updates to tags made via the REST API will not be reflected on the board in realtime. To see REST API updates to tags on a board, you need to refresh the board. This ap

Lua path
app.integrations.miro.remove_tag_from_item
Full name
miro.miro_remove_tag_from_item
ParameterTypeRequiredDescription
No parameters.
enterprise_create_project Write

Projects are essentially folders of boards with the option to manage user access for a smaller group of people within a team. Projects are here to help you organize your boards and make them easier to find and share. In other words, a project is a group of boa

Lua path
app.integrations.miro.enterprise_create_project
Full name
miro.miro_enterprise_create_project
ParameterTypeRequiredDescription
No parameters.
enterprise_get_projects Read

Retrieves the list of projects in an existing team of an organization. You can retrieve all projects, including all private projects (projects that haven't been specifically shared with you) by enabling Content Admin permissions. To enable Content Admin permis

Lua path
app.integrations.miro.enterprise_get_projects
Full name
miro.miro_enterprise_get_projects
ParameterTypeRequiredDescription
No parameters.
enterprise_get_project Read

Retrieves project information, such as a name for an existing project.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:read Rate limiting Level 1 Enterprise only This API is available only for Enterpr

Lua path
app.integrations.miro.enterprise_get_project
Full name
miro.miro_enterprise_get_project
ParameterTypeRequiredDescription
No parameters.
enterprise_update_project Write

Update information about a project, such as the project name.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan

Lua path
app.integrations.miro.enterprise_update_project
Full name
miro.miro_enterprise_update_project
ParameterTypeRequiredDescription
No parameters.
enterprise_delete_project Write

Deletes a project. After a project is deleted, all boards and users that belong to the project remain in the team.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:write Rate limiting Level 4 Enterpris

Lua path
app.integrations.miro.enterprise_delete_project
Full name
miro.miro_enterprise_delete_project
ParameterTypeRequiredDescription
No parameters.
enterprise_get_project_settings Read

Retrieves the project settings.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this e

Lua path
app.integrations.miro.enterprise_get_project_settings
Full name
miro.miro_enterprise_get_project_settings
ParameterTypeRequiredDescription
No parameters.
enterprise_update_project_settings Write

Updates the settings of a project.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use th

Lua path
app.integrations.miro.enterprise_update_project_settings
Full name
miro.miro_enterprise_update_project_settings
ParameterTypeRequiredDescription
No parameters.
enterprise_add_project_member Write

Add a Miro user to a project.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this en

Lua path
app.integrations.miro.enterprise_add_project_member
Full name
miro.miro_enterprise_add_project_member
ParameterTypeRequiredDescription
No parameters.
enterprise_get_project_members Read

Retrieves the list of members for a specific project.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. Y

Lua path
app.integrations.miro.enterprise_get_project_members
Full name
miro.miro_enterprise_get_project_members
ParameterTypeRequiredDescription
No parameters.
enterprise_get_project_member Read

Retrieves information for a specific project member.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. Yo

Lua path
app.integrations.miro.enterprise_get_project_member
Full name
miro.miro_enterprise_get_project_member
ParameterTypeRequiredDescription
No parameters.
enterprise_update_project_member Write

Updates details of a project member, such as the member's role.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise pl

Lua path
app.integrations.miro.enterprise_update_project_member
Full name
miro.miro_enterprise_update_project_member
ParameterTypeRequiredDescription
No parameters.
enterprise_delete_project_member Write

Remove a member from a project. The user remains in the team even after the member is removed from a project.Note Projects have been renamed to Spaces, and the terms can be used interchangeably.Required scope projects:write Rate limiting Level 4 Enterprise onl

Lua path
app.integrations.miro.enterprise_delete_project_member
Full name
miro.miro_enterprise_delete_project_member
ParameterTypeRequiredDescription
No parameters.
enterprise_create_team Write

Creates a new team in an existing organization. Required scope organizations:teams:write Rate limiting Level 1 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. You can

Lua path
app.integrations.miro.enterprise_create_team
Full name
miro.miro_enterprise_create_team
ParameterTypeRequiredDescription
No parameters.
enterprise_get_teams Read

Retrieves list of teams in an existing organization. Required scope organizations:teams:read Rate limiting Level 1 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. You

Lua path
app.integrations.miro.enterprise_get_teams
Full name
miro.miro_enterprise_get_teams
ParameterTypeRequiredDescription
No parameters.
enterprise_get_team Read

Retrieves team information for an existing team. Required scope organizations:teams:read Rate limiting Level 1 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. You can

Lua path
app.integrations.miro.enterprise_get_team
Full name
miro.miro_enterprise_get_team
ParameterTypeRequiredDescription
No parameters.
enterprise_update_team Write

Updates an existing team. Required scope organizations:teams:write Rate limiting Level 1 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. You can request temporary acc

Lua path
app.integrations.miro.enterprise_update_team
Full name
miro.miro_enterprise_update_team
ParameterTypeRequiredDescription
No parameters.
enterprise_delete_team Write

Deletes an existing team. Required scope organizations:teams:write 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. You can request temporary acc

Lua path
app.integrations.miro.enterprise_delete_team
Full name
miro.miro_enterprise_delete_team
ParameterTypeRequiredDescription
No parameters.
enterprise_invite_team_member Write

Invites a new Miro user to an existing team. The user must exist in your Miro organization. Users who do not exist in your Miro organization can be invited to the team via [SCIM](https://developers.miro.com/docs/scim) and an external identity provider, such as

Lua path
app.integrations.miro.enterprise_invite_team_member
Full name
miro.miro_enterprise_invite_team_member
ParameterTypeRequiredDescription
No parameters.
enterprise_get_team_members Read

Retrieves team members by cursor. Required scope organizations:teams:read Rate limiting Level 2 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. You can request tempor

Lua path
app.integrations.miro.enterprise_get_team_members
Full name
miro.miro_enterprise_get_team_members
ParameterTypeRequiredDescription
No parameters.
enterprise_get_team_member Read

Retrieves team member by id. Required scope organizations:teams:read Rate limiting Level 1 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. You can request temporary a

Lua path
app.integrations.miro.enterprise_get_team_member
Full name
miro.miro_enterprise_get_team_member
ParameterTypeRequiredDescription
No parameters.
enterprise_update_team_member Write

Updates team member role in team by id. Required scope organizations:teams:write Rate limiting Level 2 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. You can request

Lua path
app.integrations.miro.enterprise_update_team_member
Full name
miro.miro_enterprise_update_team_member
ParameterTypeRequiredDescription
No parameters.
enterprise_delete_team_member Write

Deletes team member from team by id. Required scope organizations:teams:write Rate limiting Level 1 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. You can request te

Lua path
app.integrations.miro.enterprise_delete_team_member
Full name
miro.miro_enterprise_delete_team_member
ParameterTypeRequiredDescription
No parameters.
enterprise_get_default_team_settings Read

Retrieves default team settings of an existing organization. Required scope organizations:teams:read Rate limiting Level 1 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 Ad

Lua path
app.integrations.miro.enterprise_get_default_team_settings
Full name
miro.miro_enterprise_get_default_team_settings
ParameterTypeRequiredDescription
No parameters.
enterprise_get_team_settings Read

Retrieves team settings of an existing team. Required scope organizations:teams:read Rate limiting Level 1 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. You can req

Lua path
app.integrations.miro.enterprise_get_team_settings
Full name
miro.miro_enterprise_get_team_settings
ParameterTypeRequiredDescription
No parameters.
enterprise_update_team_settings Write

Updates team settings of an existing team. Required scope organizations:teams:write Rate limiting Level 2 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. You can requ

Lua path
app.integrations.miro.enterprise_update_team_settings
Full name
miro.miro_enterprise_update_team_settings
ParameterTypeRequiredDescription
No parameters.
enterprise_get_groups Read

Retrieves the list of user groups in an organization. Required scope organizations:groups:read Rate limiting Level 1 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. Y

Lua path
app.integrations.miro.enterprise_get_groups
Full name
miro.miro_enterprise_get_groups
ParameterTypeRequiredDescription
No parameters.
enterprise_create_group Write

Creates a new user group in an organization. Required scope organizations:groups:write Rate limiting Level 1 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. You can r

Lua path
app.integrations.miro.enterprise_create_group
Full name
miro.miro_enterprise_create_group
ParameterTypeRequiredDescription
No parameters.
enterprise_get_group Read

Retrieves a user group in an organization. Required scope organizations:groups:read Rate limiting Level 1 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. You can requ

Lua path
app.integrations.miro.enterprise_get_group
Full name
miro.miro_enterprise_get_group
ParameterTypeRequiredDescription
No parameters.
enterprise_update_group Write

Updates a user group in an organization. Required scope organizations:groups:write Rate limiting Level 1 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. You can reque

Lua path
app.integrations.miro.enterprise_update_group
Full name
miro.miro_enterprise_update_group
ParameterTypeRequiredDescription
No parameters.
enterprise_delete_group Write

Deletes a user group from an organization. Required scope organizations:groups:write 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. You can req

Lua path
app.integrations.miro.enterprise_delete_group
Full name
miro.miro_enterprise_delete_group
ParameterTypeRequiredDescription
No parameters.
enterprise_get_group_members Read

Retrieves the list of members who are part of a team in an existing organization. Required scope organizations:groups:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you have th

Lua path
app.integrations.miro.enterprise_get_group_members
Full name
miro.miro_enterprise_get_group_members
ParameterTypeRequiredDescription
No parameters.
enterprise_create_group_member Write

Adds a member to a user group in an organization. Required scope organizations:groups:write Rate limiting Level 1 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. You

Lua path
app.integrations.miro.enterprise_create_group_member
Full name
miro.miro_enterprise_create_group_member
ParameterTypeRequiredDescription
No parameters.
enterprise_update_group_members Write

Add and remove members in one request. For example, remove user A and add user B. You can add or remove up to 500 users at a time. Required scope organizations:groups:write Rate limiting Level 1 per item. For example, if you want to add 10 users and remove 5,

Lua path
app.integrations.miro.enterprise_update_group_members
Full name
miro.miro_enterprise_update_group_members
ParameterTypeRequiredDescription
No parameters.
enterprise_get_group_member Read

Retrieves information about a user group member in an organization. Required scope organizations:groups:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Co

Lua path
app.integrations.miro.enterprise_get_group_member
Full name
miro.miro_enterprise_get_group_member
ParameterTypeRequiredDescription
No parameters.
enterprise_delete_group_member Write

Removes a member from a user group in an organization. Required scope organizations:groups:write 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.

Lua path
app.integrations.miro.enterprise_delete_group_member
Full name
miro.miro_enterprise_delete_group_member
ParameterTypeRequiredDescription
No parameters.
enterprise_groups_get_teams Read

Retrieves the list of teams that the user group is a part of. Required scope organizations:groups:read organizations:teams:readRate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you hav

Lua path
app.integrations.miro.enterprise_groups_get_teams
Full name
miro.miro_enterprise_groups_get_teams
ParameterTypeRequiredDescription
No parameters.
enterprise_groups_get_team Read

Retrieves information of a team that the user group is a part of in an organization. Required scope organizations:groups:read organizations:teams:readRate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use t

Lua path
app.integrations.miro.enterprise_groups_get_team
Full name
miro.miro_enterprise_groups_get_team
ParameterTypeRequiredDescription
No parameters.
enterprise_teams_get_groups Read

Retrieves the list of user groups that are part of a team in an organization. Required scope organizations:groups:read organizations:teams:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this en

Lua path
app.integrations.miro.enterprise_teams_get_groups
Full name
miro.miro_enterprise_teams_get_groups
ParameterTypeRequiredDescription
No parameters.
enterprise_teams_create_group Write

Adds a user group to a team in an organization. Required scope organizations:groups:read organizations:teams:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you have the role o

Lua path
app.integrations.miro.enterprise_teams_create_group
Full name
miro.miro_enterprise_teams_create_group
ParameterTypeRequiredDescription
No parameters.
enterprise_teams_get_group Read

Retrieves information about a specific user group of a team. Required scope organizations:groups:read organizations:teams:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you hav

Lua path
app.integrations.miro.enterprise_teams_get_group
Full name
miro.miro_enterprise_teams_get_group
ParameterTypeRequiredDescription
No parameters.
enterprise_teams_delete_group Write

Removes a user group from a team in an existing organization. Required scope organizations:groups:read organizations:teams:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you h

Lua path
app.integrations.miro.enterprise_teams_delete_group
Full name
miro.miro_enterprise_teams_delete_group
ParameterTypeRequiredDescription
No parameters.
enterprise_boards_get_groups Read

Retrieves information about user groups invited to the specified board. Required scope organizations:groups:read boards:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you have

Lua path
app.integrations.miro.enterprise_boards_get_groups
Full name
miro.miro_enterprise_boards_get_groups
ParameterTypeRequiredDescription
No parameters.
enterprise_boards_create_group Write

Shares a board with user groups with a specified role. Updates the role if already shared. Required scope organizations:groups:read boards:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this e

Lua path
app.integrations.miro.enterprise_boards_create_group
Full name
miro.miro_enterprise_boards_create_group
ParameterTypeRequiredDescription
No parameters.
enterprise_boards_delete_groups Write

Removes a user group from the specified board. Required scope organizations:groups:read boards:write Rate limiting Level 1 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 Ad

Lua path
app.integrations.miro.enterprise_boards_delete_groups
Full name
miro.miro_enterprise_boards_delete_groups
ParameterTypeRequiredDescription
No parameters.
enterprise_projects_get_groups Read

Retrieves information about user groups invited to the specified project. Required scope organizations:groups:read projects:read Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you h

Lua path
app.integrations.miro.enterprise_projects_get_groups
Full name
miro.miro_enterprise_projects_get_groups
ParameterTypeRequiredDescription
No parameters.
enterprise_project_create_group Write

Shares a project with user groups with a specified role. Updates the role if already shared. Required scope organizations:groups:read projects:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use th

Lua path
app.integrations.miro.enterprise_project_create_group
Full name
miro.miro_enterprise_project_create_group
ParameterTypeRequiredDescription
No parameters.
enterprise_project_delete_groups Write

Removes a user group from the specified project. Required scope organizations:groups:read projects:write Rate limiting Level 1 Enterprise only This API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Compan

Lua path
app.integrations.miro.enterprise_project_delete_groups
Full name
miro.miro_enterprise_project_delete_groups
ParameterTypeRequiredDescription
No parameters.