Create board

POST /v2/boards

Creates a board with the specified name and sharing policies.

Required scope

boards:write

Rate limiting

Level 3

Request

application/json

Body

description string

Possible values: <= 300 characters

Description of the board.

name string

Possible values: non-empty and <= 60 characters

Default value: Untitled

Name for the board.

policy

object

Defines the permissions policies and sharing policies for the board.

permissionsPolicy

object

Defines the permissions policies for the board.

collaborationToolsStartAccess string

Possible values: [all_editors, board_owners_and_coowners]

Default value: all_editors

Defines who can start or stop timer, voting, video chat, screen sharing, attention management. Others will only be able to join. To change the value for the collaborationToolsStartAccess parameter, contact Miro Customer Support.

copyAccess string

Possible values: [anyone, team_members, team_editors, board_owner]

Default value: anyone

Defines who can copy the board, copy objects, download images, and save the board as a template or PDF.

sharingAccess string

Possible values: [team_members_with_editing_rights, owner_and_coowners]

Default value: team_members_with_editing_rights

Defines who can change access and invite users to this board. To change the value for the sharingAccess parameter, contact Miro Customer Support.

sharingPolicy

object

Defines the public-level, organization-level, and team-level access for the board. The access level that a user gets depends on the highest level of access that results from considering the public-level, team-level, organization-level, and direct sharing access.

access string

Possible values: [private, view, edit, comment]

Default value: private

Defines the public-level access to the board.

inviteToAccountAndBoardLinkAccess string

Possible values: [viewer, commenter, editor, no_access]

Default value: no_access

Defines the user role when inviting a user via the invite to team and board link. For Enterprise users, the inviteToAccountAndBoardLinkAccess parameter is always set to no_access regardless of the value that you assign for this parameter.

organizationAccess string

Possible values: [private, view, comment, edit]

Default value: private

Defines the organization-level access to the board. If the board is created for a team that does not belong to an organization, the organizationAccess parameter is always set to the default value.

teamAccess string

Possible values: [private, view, comment, edit]

Default value: private

Defines the team-level access to the board.

teamId string

Unique identifier (ID) of the team where the board must be placed.

projectId string

Unique identifier (ID) of the project to which the board must be added.

Responses

Board created

application/json

Schema
Example (from schema)

Schema

id stringrequired

Unique identifier (ID) of the board.

name stringrequired

Name of the board.

description stringrequired

Description of the board.

team

object

id stringrequired

Team id

name stringrequired

Team name

picture

object

id int64

Id of the picture

imageURL string

Url of the picture

originalUrl string

Original team picture url for icon generation

type string

Default value: picture

Type of the object returned.

type string

Default value: team

Type of the object returned.

project

object

id stringrequired

Project ID.

name stringrequired

Name of the project.

type stringrequired

Default value: project

Type of the object returned.

picture

object

id int64

Id of the picture

imageURL string

Url of the picture

originalUrl string

Original team picture url for icon generation

type string

Default value: picture

Type of the object returned.

policy

object

Defines the permissions policies and sharing policies for the board.

permissionsPolicy

object

Defines the permissions policies for the board.

collaborationToolsStartAccess string

Possible values: [all_editors, board_owners_and_coowners]

Default value: all_editors

copyAccess string

Possible values: [anyone, team_members, team_editors, board_owner]

Default value: anyone

Defines who can copy the board, copy objects, download images, and save the board as a template or PDF.

sharingAccess string

Possible values: [team_members_with_editing_rights, owner_and_coowners]

Default value: team_members_with_editing_rights

Defines who can change access and invite users to this board. To change the value for the sharingAccess parameter, contact Miro Customer Support.

sharingPolicy

object

access string

Possible values: [private, view, edit, comment]

Defines the public-level access to the board.

inviteToAccountAndBoardLinkAccess string

Possible values: [viewer, commenter, editor, coowner, owner, guest, no_access]

Default value: no_access

Defines the user role when inviting a user via the invite to team and board link. For Enterprise users, the inviteToAccountAndBoardLinkAccess parameter is always set to no_access.

organizationAccess string

Possible values: [private, view, comment, edit]

Default value: private

Defines the organization-level access to the board. If the board is created for a team that does not belong to an organization, the organizationAccess parameter is always set to the default value.

teamAccess string

Possible values: [private, view, comment, edit]

Defines the team-level access to the board.

viewLink string

URL to view the board.

owner

object

Contains information about the user who created the board.

id stringrequired

Unique identifier (ID) of the user.

name stringrequired

Name of the user.

type stringrequired

Indicates the type of object returned. In this case, type returns user.

currentUserMembership

object

Contains the current user's board membership details. The current user could be different from the board owner.

id stringrequired

Unique identifier (ID) of the user.

name stringrequired

Name of the user.

role string

Possible values: [viewer, commenter, editor, coowner, owner]

Role of the board member.

type stringrequired

Type of the object that is returned. In this case, type returns board_member.

createdAt date-time

Date and time when the board was created. Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

createdBy

object

Contains information about the user who created the board.

id stringrequired

Unique identifier (ID) of the user.

name stringrequired

Name of the user.

type stringrequired

Indicates the type of object returned. In this case, type returns user.

modifiedAt date-time

Date and time when the board was last modified. Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

modifiedBy

object

Contains information about the user who created the board.

id stringrequired

Unique identifier (ID) of the user.

name stringrequired

Name of the user.

type stringrequired

Indicates the type of object returned. In this case, type returns user.

links

object

Contains applicable links for the board.

related string

Link to obtain information about the board members associated with the board.

self string

Link to obtain information about the current board.

type stringrequired

Type of the object that is returned. In this case, type returns board.

{
  "id": "uXjVOD6LSME=",
  "name": "Sample board name",
  "description": "Sample board description",
  "team": {
    "id": "3074457345618265000",
    "name": "My Team",
    "picture": {
      "id": 3074457345618261500,
      "imageURL": "https://miro.images/5252525252/125252/266/144/1/size210.jpg",
      "originalUrl": "https://miro.com/original-image.jpg",
      "type": "picture"
    },
    "type": "team"
  },
  "project": {
    "id": "3074457345618265000",
    "name": "Product Guild project",
    "type": "project"
  },
  "picture": {
    "id": 3074457345618261500,
    "imageURL": "https://miro.images/5252525252/125252/266/144/1/size210.jpg",
    "originalUrl": "https://miro.com/original-image.jpg",
    "type": "picture"
  },
  "policy": {
    "permissionsPolicy": {
      "collaborationToolsStartAccess": "all_editors",
      "copyAccess": "anyone",
      "sharingAccess": "team_members_with_editing_rights"
    },
    "sharingPolicy": {
      "access": "private",
      "inviteToAccountAndBoardLinkAccess": "no_access",
      "organizationAccess": "private",
      "teamAccess": "private"
    }
  },
  "viewLink": "https://miro.com/app/board/uXjVOD6LSME=",
  "owner": {
    "id": "3074457353169356300",
    "name": "John Smith",
    "type": "user"
  },
  "currentUserMembership": {
    "id": "3074457353169356300",
    "name": "John Smith",
    "role": "viewer",
    "type": "board_member"
  },
  "createdAt": "2024-04-11T15:04:04.093Z",
  "createdBy": {
    "id": "3074457353169356300",
    "name": "John Smith",
    "type": "user"
  },
  "modifiedAt": "2024-04-11T15:04:04.093Z",
  "modifiedBy": {
    "id": "3074457353169356300",
    "name": "John Smith",
    "type": "user"
  },
  "links": {
    "related": "http://api.miro.com/v2/boards/o9J_k1JKioQ=/members?limit=20&offset=0",
    "self": "http://api.miro.com/v2/boards/o9J_k1JKioQ="
  },
  "type": "board"
}

Malformed request

application/json

Schema
Example (from schema)

Schema

code string

Code of the error

message string

Description of the error

status int32

Status code of the error

type string

Type of the error

{
  "code": "error",
  "message": "Error message",
  "status": 400,
  "type": "error"
}

Not found

application/json

Schema
Example (from schema)

Schema

code string

Code of the error

message string

Description of the error

status int32

Status code of the error

type string

Type of the error

{
  "code": "error",
  "message": "Error message",
  "status": 400,
  "type": "error"
}

Too many requests

application/json

Schema
Example (from schema)

Schema

code string

Code of the error

message string

Description of the error

status int32

Status code of the error

type string

Type of the error

{
  "code": "error",
  "message": "Error message",
  "status": 400,
  "type": "error"
}

Create board

/v2/boards

Required scope

Rate limiting

Request​

Body

Responses​

Request

Responses