# List Updates — monday

> List the updates (comments) posted on a board's items, including each update's ID, body and author. Use this to discover the Parent Update ID required by Create an Update when replying to an existing update. Set Board ID. Example: Limit…

- Key: `monday-list-updates`
- Type: Action (Read-only)
- Version: 0.0.1
- App: monday (`monday`) — https://pipedream.com/apps/monday.md
- This page (HTML): https://pipedream.com/apps/monday/actions/list-updates
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/monday/actions/list-updates/list-updates.mjs

## Description

List the updates (comments) posted on a board's items, including each update's ID, body and author. Use this to discover the `Parent Update ID` required by **Create an Update** when replying to an existing update. Set `Board ID`. Example: Limit `25`, Page `1`. Returns an array of update objects, each carrying the `item_id` of the item it was posted on. If exactly `Limit` updates come back there are probably more — call again with `Page` incremented by 1. [See the documentation](https://developer.monday.com/api-reference/reference/updates#queries)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `boardId` | `string` | Yes | The board to act on, as a board ID (e.g. 2419687965). Use List Board ID Options to look up a board ID by name. Options are loaded from the connected account. |
| `limit` | `integer` | No | The maximum number of updates to return per page. Defaults to 25. If exactly this many updates are returned there are probably more, so call again with Page incremented by 1. |
| `page` | `integer` | No | The page number to return, starting at 1. Increment this to walk through updates when a call returns a full page of Limit results. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "monday",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "monday-list-updates",
  arguments: {
    boardId: "Board ID",
    limit: 10,
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "monday-list-updates",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    monday: { authProvisionId: "apn_xxxxxxx" },
    boardId: "Board ID",
    limit: 10,
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "monday-list-updates",
    "configured_props": {
      "monday": { "authProvisionId": "apn_xxxxxxx" },
      "boardId": "Board ID",
      "limit": 10
    }
  }'
```

---

- App: https://pipedream.com/apps/monday.md · All apps: https://pipedream.com/apps