# Get workspace AGENTS.md

`get_workspace_agents`

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

**The rules that bind you in this workspace** — its root AGENTS.md: how work arrives, what you may edit, what you must not do, whose folders are whose — or null if it has none. Read it before your first action here, not only when asked about your role.

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

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

## Arguments

| Name | Type | Required | Travels in | Description |
|---|---|---|---|---|
| `workspace_id` | string | yes | query string | Workspace id |

## Success

`200` with `application/json`.

## Example request

```sh
curl 'https://api.markdownbrain.ai/v1/agents?workspace_id=00000000-0000-4000-8000-000000000010' \
  -H "Authorization: Bearer $MDBRAIN_API_KEY"
```

```sh
mdbrain call get_workspace_agents \
  --workspace-id 00000000-0000-4000-8000-000000000010
```

## Example response

> Written from the code rather than captured from a call.

```json
{
  "workspaceId": "00000000-0000-4000-8000-000000000010",
  "present": true,
  "fileId": "00000000-0000-4000-8000-000000000100",
  "content": "# House rules\n\nWork arrives as comments that mention you. Reply on the thread when you finish; never resolve it.\n"
}
```

## Refusals

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