---
title: "Export timeline document as OTIO"
method: POST
path: "/api/v1/timelines/export/otio"
tags: ["Timelines"]
---

# Export timeline document as OTIO

`POST /api/v1/timelines/export/otio`

## Request

- Base URL: `https://api.studio.kaitoi.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.studio.kaitoi.io/api/v1/timelines/export/otio`
- Auth: HTTP bearer

Converts a Kaitoi Timeline Document v1 to an OpenTimelineIO ZIP bundle. The ZIP contains `timeline.otio` and any media files the API can resolve from the authenticated account. OTIO media references are portable filenames, never server paths, storage roots, private bucket keys, or signed URLs.

## Headers

- `authorization` string, nullable

## Request body

- PublicTimelineOtioExportRequest
  - `document` object, required: Kaitoi Timeline Document v1 JSON to export as OpenTimelineIO.

## Response `200`

OTIO ZIP bundle.

- unknown

## Other responses

- `400`: The timeline document is invalid.
- `401`: Missing, malformed, expired, or revoked bearer token.
- `403`: The API key lacks the required scope or account capability.
- `422`: Validation Error
- `429`: The client or API key exceeded the REST API rate limit.
- `501`: OpenTimelineIO is unavailable.
- `503`: The shared REST API rate limiter is temporarily unavailable.

---

[API](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api.md) · [All operations](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaitoi/apis/kaitoi-rest-api/revisions/239a74aa2c64?raw)