---
title: "Init Recording Upload"
method: POST
path: "/v1/campaigns/{campaign_id}/recordings/init"
tags: ["recordings", "product-api"]
---

# Init Recording Upload

`POST /v1/campaigns/{campaign_id}/recordings/init`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/campaigns/{campaign_id}/recordings/init`
- Auth: HTTP bearer

## Path parameters

- `campaign_id` string, required

## Headers

- `x-api-key` string, nullable

## Request body

- RecordingInitRequest
  - `file_name` string, required
  - `file_size_bytes` integer, required
  - `duration_seconds` integer, required
  - `content_type` string, required
  - `session_title` string, nullable
  - `session_date` string, date-time, nullable
  - `speaker_ids` string[]
  - `credit_type` 'monthly' | 'extra', nullable

## Response `201`

Successful Response

- RecordingInitResponse
  - `session_id` string, required
  - `object_key` string, required
  - `r2_upload_id` string, required
  - `part_size_bytes` integer, required
  - `total_parts` integer, required
  - `part_urls` RecordingPartUrl[], required
    - `part_number` integer, required
    - `url` string, required
    - `expires_in_seconds` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/myarchivist/apis/archivist-public-api.md) · [All operations](https://skmtc.dev/myarchivist/apis/archivist-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myarchivist/apis/archivist-public-api/revisions/3ea6ca7efc56?raw)