Promote a ready focus segment into a saved library track. Returns 201 Created with the new track. The track is added to the caller's library.
Use this to keep a focus segment you liked. A session or segment you do not own returns 404.
organization_id string required
The organization the session is scoped to. The caller must belong to it.
session_id string required
The focus session id (mfocus_-prefixed).
segment_index integer required
Zero-based index of the ready segment to promote.
The created track.
track_id string · Id of the created track (mtrack_-prefixed).
title string · Title of the promoted track.
engine string · Internal engine key the track was generated with.
licence_class string · Neutral licence tier: commercial_cleared, commercial_enterprise, personal_only, or unclear.
measured_duration_seconds number · Measured duration of the track in seconds.
- Bash
- Python
- Python
- JavaScript
curl -X POST "https://api.aitronos.com/v1/music/org_abc123/focus/sessions/mfocus_7c2a9f4e1b8d/segments/0/promote" \
-H "X-API-Key: $FREDDY_API_KEY"Response:
{
"track_id": "mtrack_b4d9e1c6a72f",
"title": "Focus Session — Segment 1",
"engine": "studio",
"licence_class": "personal_only",
"measured_duration_seconds": 120.4
}