---
title: "Add Segment Sfx Endpoint"
method: POST
path: "/segments/{segment_id}/sfx"
tags: ["segments"]
---

# Add Segment Sfx Endpoint

`POST /segments/{segment_id}/sfx`

## Request

- Base URL: `https://api.framesail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.framesail.com/segments/{segment_id}/sfx`
- Auth: HTTP bearer

Manually add a new SFX asset to a segment from the audio library.

Unlike `assign-library` (which fills an existing, storyboard-generated SFX
slot), this creates a brand-new `sfx` segment_asset assigned to the chosen
track and appends a matching audio layer to the scene so it flows through to
the editor without a scene rebuild.

## Path parameters

- `segment_id` string, required

## Request body

- AssignLibraryTrackRequest
  - `library_track_id` string, required

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/framesail/apis/framesail-api.md) · [All operations](https://skmtc.dev/framesail/apis/framesail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framesail/apis/framesail-api/revisions/12602eae0820?raw)