Skip to main content
POST
Ingest, read, or select context

Authorizations

x-api-key
string
header
required

Body

application/json
action
string
required
Allowed value: "ingest"
url
string<uri>
required

Spotify track URL. Albums, playlists and YouTube ingestion are not enabled in this pilot.

idempotency_key
string
required

Stable key for retrying the same input without duplicate work.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]+$
organization_id
string<uuid>

Optional organization that owns the private context. Current membership is checked.

topics
enum<string>[]
Required array length: 1 - 10 elements
Available options:
release_metadata,
artist_metadata,
catalog_metadata,
lyrics,
song_summary,
artwork_branding,
artist_research,
artist_brand,
era,
video_narrative
direction
string

Stored customer direction. Metadata extraction does not interpret it as source facts.

Maximum string length: 4000

Response

Read returns request. Brief returns purpose, readiness, documents, characters, missingTopics, guidance and gaps. Documents include saved result/version references and source citations.