# Mural

> Run your Mural whiteboards from a workflow: create rooms and murals, add and edit sticky notes and text boxes, tag ideas and read what your team put on a board.

App · 29 actions. Web page: https://docs.lodol.com/docs/integrations/mural

## Actions

### Add sticky note

Add a sticky note to a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Text (`text`, text, required): What the sticky note says.
- Left position (`x`, number): Where the left edge goes on the canvas. Default 0.
- Top position (`y`, number): Where the top edge goes on the canvas. Default 0.
- Shape (`shape`, text): Square or circle. Default square. One of: `rectangle` (Square), `circle`. Default: `rectangle`.
- Colour (`background_color`, text): The note's colour. A hex colour such as #FFEB00.
- Width (`width`, number): Width in pixels.
- Height (`height`, number): Height in pixels.
- Inside area (`parent_id`, text): Put it inside this area, by its widget ID.

**Outputs**

- `widget` (object): The widget

**Example output**

```json
{
  "widget": {
    "background_color": "#FFEB00FF",
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "height": 138,
    "hidden": false,
    "id": "0-1608152669001",
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000?wid=0-1608152669001",
    "locked": false,
    "parent_id": "",
    "rotation": 0,
    "shape": "rectangle",
    "tags": [],
    "text": "Ship it",
    "title": "",
    "type": "sticky note",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-01T00:00:00Z",
    "width": 138,
    "x": 0,
    "y": 0
  }
}
```

### Add text box

Add a text box to a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Text (`text`, text, required): What the text box says.
- Left position (`x`, number): Where the left edge goes on the canvas. Default 0.
- Top position (`y`, number): Where the top edge goes on the canvas. Default 0.
- Width (`width`, number): Width in pixels.
- Height (`height`, number): Height in pixels.
- Font size (`font_size`, number): Text size in points.
- Alignment (`text_align`, text): How the text lines up. One of: `left`, `center`, `right`.

**Outputs**

- `widget` (object): The widget

**Example output**

```json
{
  "widget": {
    "background_color": "#FFEB00FF",
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "height": 138,
    "hidden": false,
    "id": "0-1608152669001",
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000?wid=0-1608152669001",
    "locked": false,
    "parent_id": "",
    "rotation": 0,
    "shape": "rectangle",
    "tags": [],
    "text": "Ship it",
    "title": "",
    "type": "sticky note",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-01T00:00:00Z",
    "width": 138,
    "x": 0,
    "y": 0
  }
}
```

### Create folder

Create a folder in a room, optionally inside another folder.

**Inputs**

- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.
- Name (`name`, text, required): The folder's name.
- Inside folder (`parent_id`, text): Create it inside this folder. Leave blank for the room's top level.

**Outputs**

- `folder` (object): The folder

**Example output**

```json
{
  "folder": {
    "id": "f-1",
    "name": "Q1",
    "subfolder_count": 0
  }
}
```

### Create mural

Create a blank mural in a room.

**Inputs**

- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.
- Title (`title`, text): The mural's title.
- Folder (`folder_id`, text): Put the mural in this folder of its room.
- Background colour (`background_color`, text): The canvas colour. A hex colour such as #FFEB00.
- Infinite canvas (`infinite`, true/false): A canvas with no edges. Mural's default is on.
- Width (`width`, number): Canvas width in pixels, for a canvas with edges.
- Height (`height`, number): Canvas height in pixels, for a canvas with edges.

**Outputs**

- `mural` (object): The mural

**Example output**

```json
{
  "mural": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "embed_link": "",
    "favorite": false,
    "folder_id": "",
    "height": 0,
    "id": "acme1234.1608152669000",
    "infinite": true,
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000",
    "room_id": "1608152669000",
    "status": "active",
    "thumbnail_url": "https://app.mural.co/thumb.jpg",
    "title": "Retro",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "width": 0,
    "workspace_id": "acme1234"
  }
}
```

### Create room

Create a room in a workspace.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its ID from an earlier step.
- Name (`name`, text, required): The room's name.
- Type (`room_type`, text): Open rooms can be joined by anyone in the workspace. Default open. One of: `open` (Open (everyone in the workspace can join)), `private` (Private (invite only)). Default: `open`.
- Confidential (`confidential`, true/false): Mark the room's murals as confidential.

**Outputs**

- `room` (object): The room

**Example output**

```json
{
  "room": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "description": "Quarterly planning",
    "favorite": false,
    "id": "1608152669000",
    "link": "https://app.mural.co/invitation/room/1608152669000",
    "name": "Planning",
    "type": "open",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "workspace_id": "acme1234"
  }
}
```

### Create tag

Create a tag on a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Text (`text`, text, required): The tag's text.
- Background colour (`background_color`, text): The tag's fill. A hex colour such as #FFEB00.
- Border colour (`border_color`, text): The tag's outline. A hex colour such as #FFEB00.
- Text colour (`color`, text): The tag's text. A hex colour such as #FFEB00.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "background_color": "#FFEB00FF",
    "border_color": "#000000FF",
    "color": "#000000FF",
    "id": "tag-1",
    "text": "Idea"
  }
}
```

### Delete mural

Delete a mural for good.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `mural_id` (text): The ID of the deleted mural

**Example output**

```json
{
  "deleted": true,
  "mural_id": "acme1234.1608152669000"
}
```

### Delete room

Delete a room and the murals in it.

**Inputs**

- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `room_id` (text): The ID of the deleted room

**Example output**

```json
{
  "deleted": true,
  "room_id": "1608152669000"
}
```

### Delete tag

Delete a tag from a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Tag (`tag_id`, text, required): The tag. Pick one, or give its ID from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `mural_id` (text): The mural it was on
- `tag_id` (text): The ID of the deleted tag

**Example output**

```json
{
  "deleted": true,
  "mural_id": "acme1234.1608152669000",
  "tag_id": "tag-1"
}
```

### Delete widget

Remove a sticky note, text box or any other widget from a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Widget (`widget_id`, text, required): The widget on the mural. Pick one, or give its ID from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `mural_id` (text): The mural it was on
- `widget_id` (text): The ID of the deleted widget

**Example output**

```json
{
  "deleted": true,
  "mural_id": "acme1234.1608152669000",
  "widget_id": "0-1608152669001"
}
```

### Duplicate mural

Copy a mural, with everything on it, into a room.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.
- Title of the copy (`title`, text, required): The copy's title.

**Outputs**

- `mural` (object): The new mural

**Example output**

```json
{
  "mural": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "embed_link": "",
    "favorite": false,
    "folder_id": "",
    "height": 0,
    "id": "acme1234.1608152669000",
    "infinite": true,
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000",
    "room_id": "1608152669000",
    "status": "active",
    "thumbnail_url": "https://app.mural.co/thumb.jpg",
    "title": "Retro",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "width": 0,
    "workspace_id": "acme1234"
  }
}
```

### Get mural

Get one mural with its links and settings.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.

**Outputs**

- `mural` (object): The mural

**Example output**

```json
{
  "mural": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "embed_link": "",
    "favorite": false,
    "folder_id": "",
    "height": 0,
    "id": "acme1234.1608152669000",
    "infinite": true,
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000",
    "room_id": "1608152669000",
    "status": "active",
    "thumbnail_url": "https://app.mural.co/thumb.jpg",
    "title": "Retro",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "width": 0,
    "workspace_id": "acme1234"
  }
}
```

### Get my profile

Get the name and email of the Mural account that is connected.

**Inputs**: None.

**Outputs**

- `user` (object): The connected person

**Example output**

```json
{
  "user": {
    "avatar_url": "https://app.mural.co/user1.jpg",
    "company_name": "Acme",
    "email": "user@example.com",
    "first_name": "Ada",
    "id": "u1651c4ac9145e4b8497d5982",
    "is_facilitator": false,
    "is_owner": false,
    "last_name": "Lovelace",
    "type": "member"
  }
}
```

### Get room

Get one room.

**Inputs**

- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.

**Outputs**

- `room` (object): The room

**Example output**

```json
{
  "room": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "description": "Quarterly planning",
    "favorite": false,
    "id": "1608152669000",
    "link": "https://app.mural.co/invitation/room/1608152669000",
    "name": "Planning",
    "type": "open",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "workspace_id": "acme1234"
  }
}
```

### Get widget

Get one widget from a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Widget (`widget_id`, text, required): The widget on the mural. Pick one, or give its ID from an earlier step.

**Outputs**

- `widget` (object): The widget

**Example output**

```json
{
  "widget": {
    "background_color": "#FFEB00FF",
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "height": 138,
    "hidden": false,
    "id": "0-1608152669001",
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000?wid=0-1608152669001",
    "locked": false,
    "parent_id": "",
    "rotation": 0,
    "shape": "rectangle",
    "tags": [],
    "text": "Ship it",
    "title": "",
    "type": "sticky note",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-01T00:00:00Z",
    "width": 138,
    "x": 0,
    "y": 0
  }
}
```

### Get workspace

Get one workspace.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its ID from an earlier step.

**Outputs**

- `workspace` (object): The workspace

**Example output**

```json
{
  "workspace": {
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "id": "acme1234",
    "link": "https://app.mural.co/t/acme1234",
    "locked": false,
    "name": "Acme",
    "suspended": false
  }
}
```

### List folders

List the folders in a room.

**Inputs**

- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `folders` (list): The folders
- `has_more` (true/false): True when Mural has more after these
- `next_token` (text): The 'Next page token' value that gets the next page

**Example output**

```json
{
  "count": 1,
  "folders": [
    {
      "id": "f-1",
      "name": "Q1",
      "subfolder_count": 0
    }
  ],
  "has_more": false,
  "next_token": ""
}
```

### List murals

List the murals of a workspace, or only those in one of its rooms.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its ID from an earlier step.
- Only in room (`room_id`, text): Only murals in this room. Leave blank for the whole workspace.
- Status (`status`, text): Only active or only archived murals. One of: `active`, `archived`.
- Sort by (`sort_by`, text): How to order the murals. One of: `lastModified` (Last modified), `lastCreated` (Newest first), `oldest` (Oldest first).
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `murals` (list): The murals
- `next_token` (text): The 'Next page token' value that gets the next page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "murals": [
    {
      "confidential": false,
      "created_by": "Ada Lovelace",
      "created_on": "2026-01-01T00:00:00Z",
      "embed_link": "",
      "favorite": false,
      "folder_id": "",
      "height": 0,
      "id": "acme1234.1608152669000",
      "infinite": true,
      "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000",
      "room_id": "1608152669000",
      "status": "active",
      "thumbnail_url": "https://app.mural.co/thumb.jpg",
      "title": "Retro",
      "updated_by": "Ada Lovelace",
      "updated_on": "2026-01-02T00:00:00Z",
      "width": 0,
      "workspace_id": "acme1234"
    }
  ],
  "next_token": ""
}
```

### List people on a mural

List the people who have access to a mural and whether they own or facilitate it.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `next_token` (text): The 'Next page token' value that gets the next page
- `users` (list): The people with access

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_token": "",
  "users": [
    {
      "avatar_url": "https://app.mural.co/user1.jpg",
      "company_name": "Acme",
      "email": "user@example.com",
      "first_name": "Ada",
      "id": "u1651c4ac9145e4b8497d5982",
      "is_facilitator": false,
      "is_owner": false,
      "last_name": "Lovelace",
      "type": "member"
    }
  ]
}
```

### List rooms

List the rooms of a workspace that the connected account can see.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its ID from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `next_token` (text): The 'Next page token' value that gets the next page
- `rooms` (list): The rooms

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_token": "",
  "rooms": [
    {
      "confidential": false,
      "created_by": "Ada Lovelace",
      "created_on": "2026-01-01T00:00:00Z",
      "description": "Quarterly planning",
      "favorite": false,
      "id": "1608152669000",
      "link": "https://app.mural.co/invitation/room/1608152669000",
      "name": "Planning",
      "type": "open",
      "updated_by": "Ada Lovelace",
      "updated_on": "2026-01-02T00:00:00Z",
      "workspace_id": "acme1234"
    }
  ]
}
```

### List tags

List the tags defined on a mural.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.

**Outputs**

- `count` (number): How many tags there are
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "background_color": "#FFEB00FF",
      "border_color": "#000000FF",
      "color": "#000000FF",
      "id": "tag-1",
      "text": "Idea"
    }
  ]
}
```

### List widgets

List what is on a mural: sticky notes, text boxes, shapes and the rest.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Kinds of widget (`widget_types`, list): Only these kinds. Leave empty for everything. One or more of: `sticky notes`, `texts` (Text boxes), `shapes`, `areas`, `arrows`, `comments`, `images`, `files`, `icons`.
- Inside widget (`parent_id`, text): Only widgets inside this area or widget, by its ID.
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `next_token` (text): The 'Next page token' value that gets the next page
- `widgets` (list): The widgets

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_token": "",
  "widgets": [
    {
      "background_color": "#FFEB00FF",
      "created_by": "Ada Lovelace",
      "created_on": "2026-01-01T00:00:00Z",
      "height": 138,
      "hidden": false,
      "id": "0-1608152669001",
      "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000?wid=0-1608152669001",
      "locked": false,
      "parent_id": "",
      "rotation": 0,
      "shape": "rectangle",
      "tags": [],
      "text": "Ship it",
      "title": "",
      "type": "sticky note",
      "updated_by": "Ada Lovelace",
      "updated_on": "2026-01-01T00:00:00Z",
      "width": 138,
      "x": 0,
      "y": 0
    }
  ]
}
```

### List workspaces

List the workspaces the connected account belongs to.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `next_token` (text): The 'Next page token' value that gets the next page
- `workspaces` (list): The workspaces

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_token": "",
  "workspaces": [
    {
      "created_by": "Ada Lovelace",
      "created_on": "2026-01-01T00:00:00Z",
      "id": "acme1234",
      "link": "https://app.mural.co/t/acme1234",
      "locked": false,
      "name": "Acme",
      "suspended": false
    }
  ]
}
```

### Search murals

Find murals in a workspace by title or content.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its ID from an earlier step.
- Search text (`query`, text, required): Words to look for.
- Only in room (`room_id`, text): Only search this room. Leave blank for the whole workspace.
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `murals` (list): The matching murals
- `next_token` (text): The 'Next page token' value that gets the next page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "murals": [
    {
      "confidential": false,
      "created_by": "Ada Lovelace",
      "created_on": "2026-01-01T00:00:00Z",
      "embed_link": "",
      "favorite": false,
      "folder_id": "",
      "height": 0,
      "id": "acme1234.1608152669000",
      "infinite": true,
      "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000",
      "room_id": "1608152669000",
      "status": "active",
      "thumbnail_url": "https://app.mural.co/thumb.jpg",
      "title": "Retro",
      "updated_by": "Ada Lovelace",
      "updated_on": "2026-01-02T00:00:00Z",
      "width": 0,
      "workspace_id": "acme1234"
    }
  ],
  "next_token": ""
}
```

### Search rooms

Find rooms in a workspace by name.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its ID from an earlier step.
- Search text (`query`, text, required): Words in the room's name.
- Page size (`limit`, number): How many to return, 1 to 100. The default is 25. From 1 to 100. Default: `25`.
- Next page token (`next_token`, text): To get the next page, use 'next_token' from the last page's result.

**Outputs**

- `count` (number): How many are in this answer
- `has_more` (true/false): True when Mural has more after these
- `next_token` (text): The 'Next page token' value that gets the next page
- `rooms` (list): The matching rooms

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_token": "",
  "rooms": [
    {
      "confidential": false,
      "created_by": "Ada Lovelace",
      "created_on": "2026-01-01T00:00:00Z",
      "description": "Quarterly planning",
      "favorite": false,
      "id": "1608152669000",
      "link": "https://app.mural.co/invitation/room/1608152669000",
      "name": "Planning",
      "type": "open",
      "updated_by": "Ada Lovelace",
      "updated_on": "2026-01-02T00:00:00Z",
      "workspace_id": "acme1234"
    }
  ]
}
```

### Update mural

Rename a mural, archive or restore it, mark it a favourite, move it to a folder or change its background.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- New title (`title`, text): A new title for the mural.
- Status (`status`, text): Archive the mural or make it active again. One of: `active`, `archived`.
- Favourite (`favorite`, true/false): Mark the mural as a favourite.
- Folder ID (`folder_id`, text): Move the mural to this folder, using its ID from 'List folders'.
- Background colour (`background_color`, text): The canvas colour. A hex colour such as #FFEB00.

**Outputs**

- `mural` (object): The mural

**Example output**

```json
{
  "mural": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "embed_link": "",
    "favorite": false,
    "folder_id": "",
    "height": 0,
    "id": "acme1234.1608152669000",
    "infinite": true,
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000",
    "room_id": "1608152669000",
    "status": "active",
    "thumbnail_url": "https://app.mural.co/thumb.jpg",
    "title": "Retro",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "width": 0,
    "workspace_id": "acme1234"
  }
}
```

### Update room

Rename a room, change whether it is open or private, or mark it a favourite.

**Inputs**

- Room (`room_id`, text, required): The room. Pick one, or give its ID from an earlier step.
- New name (`name`, text): A new name for the room.
- Type (`room_type`, text): Open rooms can be joined by anyone in the workspace. One of: `open` (Open (everyone in the workspace can join)), `private` (Private (invite only)).
- Favourite (`favorite`, true/false): Mark the room as a favourite.

**Outputs**

- `room` (object): The room

**Example output**

```json
{
  "room": {
    "confidential": false,
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "description": "Quarterly planning",
    "favorite": false,
    "id": "1608152669000",
    "link": "https://app.mural.co/invitation/room/1608152669000",
    "name": "Planning",
    "type": "open",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-02T00:00:00Z",
    "workspace_id": "acme1234"
  }
}
```

### Update sticky note

Change a sticky note's text, colour, position or size.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Widget (`widget_id`, text, required): The widget on the mural. Pick one, or give its ID from an earlier step.
- Text (`text`, text): New text for the note.
- Left position (`x`, number): Where the left edge goes on the canvas. Default 0.
- Top position (`y`, number): Where the top edge goes on the canvas. Default 0.
- Colour (`background_color`, text): The note's colour. A hex colour such as #FFEB00.
- Width (`width`, number): Width in pixels.
- Height (`height`, number): Height in pixels.

**Outputs**

- `widget` (object): The widget

**Example output**

```json
{
  "widget": {
    "background_color": "#FFEB00FF",
    "created_by": "Ada Lovelace",
    "created_on": "2026-01-01T00:00:00Z",
    "height": 138,
    "hidden": false,
    "id": "0-1608152669001",
    "link": "https://app.mural.co/t/acme1234/m/acme1234/1608152669000?wid=0-1608152669001",
    "locked": false,
    "parent_id": "",
    "rotation": 0,
    "shape": "rectangle",
    "tags": [],
    "text": "Ship it",
    "title": "",
    "type": "sticky note",
    "updated_by": "Ada Lovelace",
    "updated_on": "2026-01-01T00:00:00Z",
    "width": 138,
    "x": 0,
    "y": 0
  }
}
```

### Update tag

Change a tag's text or colours.

**Inputs**

- Mural (`mural_id`, text, required): The mural. Pick one, or give its ID from an earlier step.
- Tag (`tag_id`, text, required): The tag. Pick one, or give its ID from an earlier step.
- New text (`text`, text): New text for the tag.
- Background colour (`background_color`, text): The tag's fill. A hex colour such as #FFEB00.
- Border colour (`border_color`, text): The tag's outline. A hex colour such as #FFEB00.
- Text colour (`color`, text): The tag's text. A hex colour such as #FFEB00.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "background_color": "#FFEB00FF",
    "border_color": "#000000FF",
    "color": "#000000FF",
    "id": "tag-1",
    "text": "Idea"
  }
}
```
