# List Workspace IDs Options — monday

> List the account's workspaces as { value, label } option pairs, to discover the Workspace IDs to pass to actions that filter across several workspaces, such as List Boards. Use when you know workspaces by name but need their IDs. Example…

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

## Description

List the account's workspaces as `{ value, label }` option pairs, to discover the `Workspace IDs` to pass to actions that filter across several workspaces, such as **List Boards**. Use when you know workspaces by name but need their IDs. Example: call with Page `1`; returns e.g. `[{ "value": 12345, "label": "Marketing" }]`. Returns at most `Limit` workspaces per page (25 by default), so if exactly `Limit` come back there are probably more — call again with `Page` incremented by 1. [See the documentation](https://developer.monday.com/api-reference/reference/workspaces)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `page` | `integer` | No | The page of results to retrieve, starting at 1. Increment this to walk through workspaces when a call returns a full page of results. |
| `limit` | `integer` | No | The maximum number of workspaces to return per page. Defaults to 25. If exactly this many are returned there are probably more, so call again with Page incremented by 1. |

## 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-workspace-ids-options",
  arguments: {
    page: 10,
    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-workspace-ids-options",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    monday: { authProvisionId: "apn_xxxxxxx" },
    page: 10,
    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-workspace-ids-options",
    "configured_props": {
      "monday": { "authProvisionId": "apn_xxxxxxx" },
      "page": 10,
      "limit": 10
    }
  }'
```

---

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