# Get magicast info

`GET /magicast.info`

## Description

Get details for a single Magicast by ID, including transcript cues,
chapters, video status, a signed video download URL when ready, and a
player URL if a share link already exists.

This is the content endpoint. [`/magicast.list`](/docs/api/magicast-list)
returns metadata only. Magicasts are not meetings — they do not appear on
[`/recording.list`](/docs/api/recording-list) or meeting transcript
surfaces, and they have no Magic Minutes summary or action items.

Asset, transcript, and share-link lookups are best-effort. If the video or
transcript is still processing, those fields are omitted and the request
still succeeds. Fetching this endpoint **never** mints a shareable link;
use [`/magicast.shareLink`](/docs/api/magicast-share-link) for that.

There is no `https://ro.am/magicast/{id}` browser URL. The player URL is
always `https://ro.am/share/{key}`.

**Access:** Organization and Personal. Organization tokens can read every
Magicast in the account, including ones the creator never shared. Personal
tokens are restricted to Magicasts owned by the authenticated user. Filter
on whether `shareUrl` is present if you only want shared recordings.

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

---

**OpenAPI Spec:** [chat-v1.json](https://developer.ro.am/chat-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `id` | query | string | Yes | The magicast ID. |

## Responses

### 200 - Magicast retrieved successfully



#### Example Response

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Q1 All-Hands Recap",
  "createdAt": "2026-01-21T18:30:00Z",
  "ownerId": "709b8a57-70bc-427a-b6f0-b16ba5297f8c",
  "coverImageUrl": "https://ro.am/card-images/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "durationMs": 184000,
  "videoStatus": "available",
  "videoUrl": "https://cdn.example/signed/magicast.mp4",
  "shareUrl": "https://ro.am/share/abcd1234-efgh5678-ijkl9012-mnop3456",
  "chapters": [
    {
      "title": "Intro",
      "startTime": 0
    },
    {
      "title": "Roadmap",
      "startTime": 32000
    }
  ],
  "cues": [
    {
      "text": "Welcome to the recap.",
      "startOffset": 0,
      "endOffset": 2400
    },
    {
      "text": "Let's look at the roadmap.",
      "startOffset": 2400,
      "endOffset": 6100
    }
  ]
}
```

### 400 - Bad request. Missing or invalid `id`.

### 401 - Presented invalid authentication credentials.

### 404 - Magicast not found.

### 405 - An unsupported method was requested.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/api/magicast-info*