---
title: "Upload Recording"
method: POST
path: "/api/v1/recordings"
tags: ["include_in_client_gen"]
---

# Upload Recording

`POST /api/v1/recordings`

## Request

- Base URL: `https://app.sagecare.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sagecare.ai/api/v1/recordings`
- Auth: API key in header `X-Session-Token`

## Request body `multipart/form-data`

- object
  - `audio_file` string, binary, required
  - `details` NewRecording, required: Input schema for uploading a new recording.
    - `organization_id` integer, required
    - `duration_seconds` integer, required
    - `patient_id` integer
    - `contact_id` integer

## Response `200`

OK

- Recording: Response schema for a recording.
  - `id` integer, required
  - `audio_file_url` string, required
  - `duration_seconds` integer, required
  - `patient_id` integer
  - `contact_id` integer
  - `uploaded_by_id` integer
  - `organization_id` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `summary` string
  - `description` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/sagecare/apis/sage-api-v1.md) - [All operations](https://skmtc.dev/sagecare/apis/sage-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/sagecare/apis/sage-api-v1/revisions/36b26ceace69?raw)