0

Create frame

by
Published Oct 17, 2025

Adds a frame to a board.Required scope boards:write Rate limiting Level 2

Script miro Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Miro = {
3
  token: string;
4
};
5
/**
6
 * Create frame
7
 * Adds a frame to a board.Required scope boards:write Rate limiting Level 2
8
 */
9
export async function main(
10
  auth: Miro,
11
  board_id: string,
12
  body: {
13
    data: {
14
      format?: "custom";
15
      title?: string;
16
      type?: "freeform";
17
      showContent?: false | true;
18
    };
19
    style?: { fillColor?: string };
20
    position?: { x?: number; y?: number };
21
    geometry?: { height?: number; width?: number };
22
  },
23
) {
24
  const url = new URL(`https://api.miro.com//v2/boards/${board_id}/frames`);
25

26
  const response = await fetch(url, {
27
    method: "POST",
28
    headers: {
29
      "Content-Type": "application/json",
30
      Authorization: "Bearer " + auth.token,
31
    },
32
    body: JSON.stringify(body),
33
  });
34
  if (!response.ok) {
35
    const text = await response.text();
36
    throw new Error(`${response.status} ${text}`);
37
  }
38
  return await response.json();
39
}
40