# List magicasts

`GET /magicast.list`

## Description

Lists all magicasts in your Roam, sorted in reverse chronological order.

**Access:** Organization and Personal. In Personal mode, only magicasts owned by the authenticated user are returned.

**Required scope:** `magicast:read`

---

**OpenAPI Spec:** [openapi.json](https://developer.ro.am/openapi.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `limit` | query | integer | No | The number of magicasts to return per response. Default is 10. |
| `cursor` | query | string | No | Opaque pagination cursor from a previous response's `nextCursor`. Do not construct cursors manually. |

## Responses

### 200 - OK

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `magicasts` | Magicast[] | No |  |
| `nextCursor` | string | No | Returned if there is a subsequent page of magicasts. |

**Magicast** (array item):

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier for the magicast |
| `name` | string | Yes | Display name of the magicast |
| `createdAt` | string | Yes | ISO-8601 timestamp when the magicast was created (UTC) |
| `ownerId` | string | No | Address ID of the magicast owner |
| `coverImageUrl` | string | No | URL for the magicast cover image thumbnail |


#### Example Response

```json
{
  "magicasts": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Q1 Product Launch Recap",
      "createdAt": "2026-03-20T14:30:00Z",
      "ownerId": "0cc74785-e31e-4403-aa5e-0cc7c1897e66",
      "coverImageUrl": "https://ro.am/assets/a1b2c3d4/thumbnail"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Weekly Standup Highlights",
      "createdAt": "2026-03-18T09:15:00Z",
      "ownerId": "6a897aa3-0cab-4ba4-a48b-4be14a9585d0",
      "coverImageUrl": "https://ro.am/assets/b2c3d4e5/thumbnail"
    }
  ],
  "nextCursor": "MjAyNi0wMy0xOFQwOToxNTowMC4wMDBa"
}
```

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/roam-api/list-magicasts*