# Prompt a meeting transcript

`POST /transcript.prompt`

## Description

Ask a question about a specific meeting transcript and receive an
AI-generated answer based on its content.

Use [`/transcript.info`](/docs/chat-api/get-transcript) to retrieve the
transcript ID, or [`/transcript.list`](/docs/chat-api/list-transcripts) to
browse available transcripts.

**Required scope:** `transcript:read`

---

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

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | The transcript ID. |
| `prompt` | string | Yes | The question to ask about the transcript. |

### Example Request

```json
{
  "id": "f9274881-c48f-4838-865d-98140ea7016d",
  "prompt": "What action items were assigned to Alex?"
}
```

## Responses

### 200 - OK

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `response` | string | No | The AI-generated answer to the prompt. |


#### Example Response

```json
{
  "response": "Alex was assigned two action items: (1) Finalize the roadmap document with updated timelines and share with stakeholders, and (2) Schedule a launch planning meeting with the product team."
}
```

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/chat-api/prompt-transcript*