Titles
Create a title
POST
Create from a TMDB id, an IMDb id, or manually. The title is placed in the catalog you name; Ingenee never picks one.
Scope: library:write
apiKeyheader
AuthorizationBearer <ik_live_…>An organisation API key from Settings → Organisation → API keys. Each operation names the one scope it needs — see https://developer.ingenee.ai/docs/authentication.
application/json- body
source*stringWhere the title comes from. manual uses the fields below.
Value in
"tmdb""imdb""manual""soundcharts""musicbrainz""wikidata""oembed""podcast"url?stringSource URL for oembed (YouTube / Vimeo) or podcast (RSS).
Length
length <= 2000kind?stringWith tmdb: whether tmdbId is a movie or a TV series.
Value in
"movie""tv"tmdbId?integerRange
0 <= valueimdbId?stringLength
2 <= length <= 20uuid?stringLength
8 <= length <= 64mbid?stringLength
8 <= length <= 64qid?stringMatch
^Q\d+$title?stringLength
length <= 500type?stringValue in
"movie""series""episode""short""song""web"year?integerRange
1850 <= value <= 2200runtimeMinutes?integerRange
0 <= value <= 100000contentRating?stringLength
length <= 20description?stringLength
length <= 5000language?stringISO 639-1 code.
Length
2 <= length <= 2catalogId?stringExisting catalog. One of catalogId / newCatalogName is required.
Format
uuidnewCatalogName?stringCreate a new catalog with this name and put the title in it.
Length
1 <= length <= 200OK
application/json- response
[key: string]?anyExample Request
curl -X POST 'https://dev.app.ingenee.ai/api/v1/titles' \ -H 'Content-Type: application/json' \ -d '{ "source": "tmdb"}'Example Response
{}