# Get a workspace

**`GET https://myagentmail.com/v1/workspaces/{id}`**

Group: Workspaces
Operation ID: `getWorkspace`

## Path parameters

- `id` (string, required) — Workspace UUID

## Responses

### 200 — OK

```json
{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "Recruiter Corp",
  "slug": "recruiter-corp",
  "isDefault": false,
  "inboxCount": 0,
  "domainCount": 0,
  "createdAt": "2026-05-01T08:11:44.637Z"
}
```

### 404 — Resource not found

```json
{
  "error": "string",
  "code": "VALIDATION_ERROR"
}
```

## Code samples

### TypeScript

```typescript
import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/workspaces/{id}
const result = await client.request("get", "/v1/workspaces/{id}", { params: { id: "00000000-0000-0000-0000-000000000000" } });
```

### curl

```bash
curl -X GET 'https://myagentmail.com/v1/workspaces/00000000-0000-0000-0000-000000000000' \
  -H 'X-API-Key: $MYAGENTMAIL_API_KEY'
```

### Python

```python
import os, requests

r = requests.get(
    "https://myagentmail.com/v1/workspaces/00000000-0000-0000-0000-000000000000",
    headers={"X-API-Key": os.environ["MYAGENTMAIL_API_KEY"]},
)
r.raise_for_status()
print(r.json())
```