---
title: "Your favorites"
description: "The pages, files, teams and projects you starred in this workspace, in the order you starred them (the sidebar's Favorites)."
canonical_url: https://docs.markdrop.in/api/teams/your-favorites
last_updated: 2026-11-20
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Your favorites

`GET https://api.markdrop.in/api/v1/workspaces/{workspace_id}/favorites`

The pages, files, teams and projects you starred in this workspace, in the order you starred them (the sidebar's Favorites). Something you can no longer open drops out of the list.

- **Authentication:** API token required: `Authorization: Bearer mdk_…`.
- **Rate limit:** 240 per minute per IP address.
- **MCP tool:** `list_favorites` ([tools](https://docs.markdrop.in/ai/tools))

## Path parameters

- `workspace_id` (string, required): The workspace's id, from the address of its settings page (`markdrop.in/settings/workspaces/<workspace-id>`) or from [List workspaces](https://docs.markdrop.in/api/workspaces/list-workspaces).

## Responses

- `200`: OK.
- `401`: No token, or the token is revoked or mistyped.
- `422`: The request didn't validate. `detail` lists each problem, with where it is (`loc`) and why (`msg`).
- `429`: Too many requests from your IP address. Wait the seconds in `Retry-After`.

## Examples

**curl**

```bash
curl https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/favorites \
  -H "Authorization: Bearer $MARKDROP_TOKEN"
```

**JavaScript**

```javascript
const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/favorites", {
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os

import requests

r = requests.get(
    "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/favorites",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
)
r.raise_for_status()
print(r.json())
```
