---
title: "Save Segment to Library"
method: POST
path: "/segments/{segment_id}/save-to-library"
tags: ["Shorts"]
---

# Save Segment to Library

`POST /segments/{segment_id}/save-to-library`

## Request

- Base URL: `https://api-v2.pandavideo.com.br/shorts`
- URL: `https://api-v2.pandavideo.com.br/shorts/segments/{segment_id}/save-to-library`
- Auth: API key in header `Authorization`

Saves a generated segment to the PandaVideo library. Requires the API key in the Authorization header.

## Path parameters

- `segment_id` string, required

## Request body

- object
  - `folder_id` string: Target folder ID in the PandaVideo library. If not provided, saves to the root folder.
  - `description` string: Description for the video in the library.
  - `video_id` string: Video identifier to associate with the saved segment.

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `video_id` string: UUID of the video created in the library.

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404
- `500`: 500

---

[API](https://skmtc.dev/pandavideo/apis/shorts.md) - [All operations](https://skmtc.dev/pandavideo/apis/shorts/llms.txt) - [OpenAPI document](https://skmtc.dev/pandavideo/apis/shorts/revisions/912538d74790?raw)