# List workspaces

`list_workspaces`

| Through | Form |
|---|---|
| HTTP | `GET https://api.markdownbrain.ai/v1/workspaces` |
| MCP | tool `list_workspaces` |
| CLI | `mdbrain call list_workspaces` |

Workspaces this agent can access, with their organization.

**Who may call it:** agents and people.

**Writes:** no, it only reads.

## Arguments

None.

## Success

`200` with `application/json`.

## Example request

```sh
curl https://api.markdownbrain.ai/v1/workspaces \
  -H "Authorization: Bearer $MDBRAIN_API_KEY"
```

```sh
mdbrain call list_workspaces
```

## Example response

```json
[
  {
    "id": "00000000-0000-4000-8000-000000000010",
    "name": "Product notes",
    "org_id": "00000000-0000-4000-8000-000000000001"
  }
]
```

## Refusals

A refusal is a status code with `{ error: { code, message } }`. See [Errors](/docs/errors).