> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.sessionboard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcriptions & Media

> Unified transcription API, session recordings, and media upload endpoints.

For step-by-step integration flows, start with the [Media & Transcriptions](https://apidocs.sessionboard.com/guides/uploading-media-and-transcriptions.md) guide. To **read** composed transcripts and AI artifacts in an app, see [Consuming session content](https://apidocs.sessionboard.com/guides/consuming-session-content.md).

## Five integration paths

| Path | Best for | Sidebar group |
| - | - | - |
| **Content packs** | One-call composed transcript + artifacts for apps | Event — Media → Transcriptions (`/content`) |
| **Transcriptions** | Raw CRUD — fragments, summaries, insights, translations | Event — Media → Transcriptions |
| **Session recordings** | Audio for a session's recording archive | Event — Media → Session recordings |
| **Media upload** | Video or audio files that should be transcribed automatically | Event — Media → Media upload |
| **Session files** | PDFs, PowerPoint, Word docs, and similar attachments | Event — Media → Session files |

> [!NOTE]
>
> **Session files** (slides, handouts, PDFs) support a one-call multipart upload (`POST .../files/upload`, max 50 MB) or direct-to-storage for larger files (up to 500 MB). Scopes: `read:sessions` / `write:sessions`. See [Uploading session files](https://apidocs.sessionboard.com/guides/uploading-session-files.md) and the [Session Files API overview](https://apidocs.sessionboard.com/api-reference/session-files.md).

## Resource model

Transcription data uses four types, all tied to a session:

| Type | Description |
| - | - |
| `fragment` | Transcript text (synced by you or created when media transcription completes) |
| `summary` | Structured summary content |
| `insight` | Topics, entities, or key phrases |
| `translation` | Translated text linked to a source artifact |

Responses use the standard envelope:

```json theme={null}
{
  "data": {
    "id": "uuid",
    "type": "fragment",
    "session_id": "uuid",
    "transcription": "...",
    "created_at": "...",
    "updated_at": "..."
  }
}
```

List endpoints include `pagination` with `current_page`, `page_size`, `total_pages`, and `total_results`.

## Session & event content

Ready-to-render packs for partners and mobile apps. Not the same as session [composition](https://apidocs.sessionboard.com/api-reference/sessions-composition.md) (abstract/parent linking).

> **[Get session content](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1content/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/content

> **[List event content](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1content/get)**
>
> GET /v1/event/{eventId}/content

> **[Event-level artifacts](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1content~1event/get)**
>
> GET /v1/event/{eventId}/content/event

> **[Get content item](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1content~1items~1%7BitemId%7D/get)**
>
> GET /v1/event/{eventId}/content/items/{itemId}

Guide: [Consuming session content](https://apidocs.sessionboard.com/guides/consuming-session-content.md).

## Transcriptions

> **[List event transcriptions](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1transcriptions/get)**
>
> GET /v1/event/{eventId}/transcriptions

> **[List session transcriptions](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1transcriptions/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/transcriptions

> **[Get session transcription](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1transcriptions~1%7BtranscriptionId%7D/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/transcriptions/{transcriptionId}

> **[Create transcription](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1transcriptions/post)**
>
> POST /v1/event/{eventId}/sessions/{sessionId}/transcriptions

## Session recordings

> **[List session recordings](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1recordings/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/recordings

> **[Start recording upload](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1recordings/post)**
>
> POST /v1/event/{eventId}/sessions/{sessionId}/recordings

> **[Get session recording](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1recordings~1%7BrecordingId%7D/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/recordings/{recordingId}

> **[Complete recording upload](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1recordings~1%7BrecordingId%7D~1complete/post)**
>
> POST .../recordings/{recordingId}/complete

## Session files

Document attachments (PDF, PowerPoint, Word, images). Full playbook: [Uploading session files](https://apidocs.sessionboard.com/guides/uploading-session-files.md). API overview: [Session Files](https://apidocs.sessionboard.com/api-reference/session-files.md).

> **[List session files](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1files/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/files

> **[Simple file upload](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1files~1upload/post)**
>
> POST /v1/event/{eventId}/sessions/{sessionId}/files/upload

> **[Direct-to-storage create](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1files/post)**
>
> POST /v1/event/{eventId}/sessions/{sessionId}/files

> **[Complete file upload](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1files~1%7BfileId%7D~1complete/post)**
>
> POST .../files/{fileId}/complete

> **[Session files guide](https://apidocs.sessionboard.com/guides/uploading-session-files.md)**
>
> Replace, update metadata, delete

## Media upload

> **[Start media upload](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1media~1upload~1initiate/post)**
>
> POST .../media/upload/initiate

> **[Get media item status](https://apidocs.sessionboard.com/api-reference/openapi.yaml#/paths/~1v1~1event~1%7BeventId%7D~1sessions~1%7BsessionId%7D~1media~1%7BmediaItemId%7D/get)**
>
> GET /v1/event/{eventId}/sessions/{sessionId}/media/{mediaItemId}

## Related reference

* [Media & Transcriptions guide](https://apidocs.sessionboard.com/guides/uploading-media-and-transcriptions.md) — step-by-step playbooks
* [Uploading session files](https://apidocs.sessionboard.com/guides/uploading-session-files.md) — PDF and document attachments
* [Session Files API overview](https://apidocs.sessionboard.com/api-reference/session-files.md)
* [Authentication & scopes](https://apidocs.sessionboard.com/authentication.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.