Channels & schedules

A channel is a 24/7 linear FAST channel with its own clock, dayparts, content scope and rules. Ingenee builds its schedule in two steps: AI proposes the dayparts and blocks, then a deterministic packer fits titles to the clock, respecting each title's runtime, the repeat window, maturity and rights. A person-editable draft is then published through a blocking validation gate, and only the published version goes to your EPG and playout feeds.

Create a channelCopy Anchor Link

curl -X POST https://dev.app.ingenee.ai/api/v1/channels \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{
    "name": "Ingenee Classic Cinema",
    "archetype": "movie",
    "timezone": "America/New_York",
    "language": "en",
    "dnaPrompt": "Golden-age Hollywood and postwar classics, warm and unhurried",
    "schedulingPrompt": "Lighter fare in the morning, prestige drama in prime time",
    "scheduleHorizon": 14,
    "autoPublish": false,
    "dayparts": [
      { "name": "Morning", "start": "06:00", "end": "12:00", "tone": "light, family-friendly", "rating": "PG" },
      { "name": "Prime", "start": "20:00", "end": "23:00", "tone": "prestige drama" }
    ]
  }'

{ "id": "f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64" }

name and dnaPrompt (the channel's character, up to 4,000 characters) are required. The rest are optional:

A channel gets a slug made from its name. The slug never changes when you rename the channel, so feed URLs stay stable. Your plan can limit the number of live channels (403 FORBIDDEN).

GET /v1/channels returns { channels: [...] } (add ?archived=1 for archived ones). GET /v1/channels/{id} returns { channel, health } with the full configuration in channel and channel.dna.

Change a channel's configurationCopy Anchor Link

PATCH /v1/channels/{id} changes any create field. Settings that live in the channel's DNA go under dna and are merged, so sending dna.dayparts doesn't reset dna.scope. adConfig is merged field by field too.

curl -X PATCH https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64 \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{
    "scheduleHorizon": 7,
    "dna": {
      "scheduling": { "mode": "fixed", "blockMin": 30 },
      "scope": { "mode": "catalogs", "catalogIds": ["0e578f59-bf28-455f-bc82-f0639a7575fb"] },
      "exclusions": ["horror"],
      "watershed": 21
    }
  }'

{ "id": "f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64", "updated": ["scheduleHorizon", "dna"] }

Useful dna keys:

Also on the body: name (a clash with another channel is 409 CONFLICT), timezone (or null), language, dnaPrompt, schedulingPrompt, streamUrl, status (idle, building, live, paused) and autoPublish. POST /v1/channels/{id}/archive and /restore take a channel off and back into the live list.

Changing settings that shape a schedule (dayparts, ads, watershed, scope, horizon, scheduling mode) matters for auto-publish. See below.

Suggest a schedule and publish itCopy Anchor Link

curl -X POST https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64/schedule/generate \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{ "startDate": "2026-11-02" }'

{
  "versionId": "6b0e1d2c-3a4f-4b5c-8d6e-7f8091a2b3c4",
  "versionNum": 7,
  "itemCount": 412,
  "itemsBuilt": 398,
  "days": 14,
  "distinctTitles": 188,
  "window": { "start": "2026-11-02T05:00:00.000Z", "end": "2026-11-16T05:00:00.000Z" },
  "published": false,
  "changedFromPrevious": true,
  "gapCount": 0,
  "gapMinutes": 0,
  "replayWarnings": [],
  "poolWarnings": [],
  "tierSplit": [],
  "dayparts": [ { "name": "Prime", "startHour": 20, "endHour": 23, "concept": "prestige drama", "allowedRating": null, "days": null } ]
}

curl https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64/publish-gate \
  -H "Authorization: Bearer $INGENEE_API_KEY"

{
  "blockers": [ "2 title(s) scheduled with expired rights — out of licence window: Captain Comet, Harbor Lights." ],
  "warnings": [ "3 airing(s) repeat a title inside the 72h window." ],
  "passing": ["Health OK — Familiarity 62 · Freshness 48"],
  "destinations": [ { "name": "EPG (XMLTV)", "path": "/channels/…/epg.xml", "ready": true } ],
  "counts": { "blockers": 1, "warnings": 1, "passing": 1 },
  "canPublish": false,
  "version": { "versionNum": 7, "itemCount": 412, "coveredDays": 14 }
}

curl -X POST https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64/publish \
  -H "Authorization: Bearer $INGENEE_API_KEY"

{ "id": "f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64", "status": "live", "versionId": "6b0e1d2c-3a4f-4b5c-8d6e-7f8091a2b3c4" }

{ "error": { "code": "BLOCKED", "message": "Cannot publish — 1 blocker(s) must be fixed first.", "details": {} } }

Read the scheduleCopy Anchor Link

{
  "id": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
  "assetId": "1b478b6a-7721-4a94-aade-55c5658f259c",
  "title": "The Long Night",
  "startsAt": "2026-11-02T01:00:00.000Z",
  "endsAt": "2026-11-02T02:48:00.000Z",
  "slotRuntimeMin": 108,
  "daypart": "Prime",
  "blockLabel": null,
  "isFiller": false,
  "rating": "TV-14",
  "lockId": null,
  "breaks": [ { "kind": "mid", "sequence": 1, "durationSec": 120, "offsetMin": 45, "scteEventType": "SPLICE_INSERT" } ]
}

A bad range returns 400 VALIDATION_FAILED. Days in the past come from the version that was current at the end of that day, which is a reconstruction rather than a transmission record (publishLog: false).

Edit the schedule by handCopy Anchor Link

Edits apply to the latest version. Publish afterwards for them to reach your feeds. Every edit refuses to overlap or cut a programme: a title is never trimmed to fit, and a clash returns 409 CONFLICT with a message saying by how much.

All of these are under /v1/channels/{id}/. The place response is { itemId, title, startMin, dur, episode, warning } with status 201.

Versions and rollbackCopy Anchor Link

curl https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64/versions \
  -H "Authorization: Bearer $INGENEE_API_KEY"

{
  "channel": { "id": "f27a91c3-…", "name": "Ingenee Classic Cinema" },
  "liveVersionId": "5c9d8e7f-…",
  "publishedAt": "2026-10-29T18:36:29.063Z",
  "versions": [
    { "id": "6b0e1d2c-…", "versionNum": 7, "itemCount": 412, "modelId": "…", "generatedAt": "…", "horizonDays": 14, "isLive": false },
    { "id": "5c9d8e7f-…", "versionNum": 6, "itemCount": 405, "modelId": "…", "generatedAt": "…", "horizonDays": 14, "isLive": true }
  ]
}

The list holds the latest 40 versions of any kind, with the live one marked. POST /v1/channels/{id}/versions/{vid}/restore copies a version's airings into a new draft version; it returns 201 with { versionId, versionNum, restoredFrom, itemCount }. The channel's status becomes building, and the restored version must pass the publish gate again before it is live.

Blocks and promotionsCopy Anchor Link

GET /v1/channels/{id}/blocks lists the channel's programming blocks.

A promotion tells the next build to prefer a title, series, collection or genre in a date window:

curl -X POST https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64/promotions \
  -H "Authorization: Bearer $INGENEE_API_KEY" -H "content-type: application/json" \
  -d '{
    "kind": "feature",
    "targetKind": "title",
    "targetRef": "1b478b6a-7721-4a94-aade-55c5658f259c",
    "startsOn": "2026-11-06", "endsOn": "2026-11-06",
    "priority": "high",
    "params": { "feature": { "timeMode": "exact", "start": "21:00" } }
  }'

201 with { "id": "…" }. kind is feature, stunt, boost or queued, and each needs its own params key: feature (timeMode exact or best, start), stunt (start, lengthMin 15 to 1440), boost (tier Heavy or Medium), queued (withinDays 1 to 90). A feature or queued promotion can target a title or series; stunt also a collection; boost also a genre (targetRef is the genre name). Optional: days (0 = Sunday), daypartId (the name of one of the channel's dayparts), priority (high, normal, low), epgLabel (none, new, premiere, season_finale, marathon), notes. The reply to GET …/promotions is { channel, promotions, counts }. A viewer key can read but not add.

Distribution readinessCopy Anchor Link

The distributors you tick on a channel are a list of keys in dna.distributors, set with PATCH. They don't create a per-channel delivery target. What they give you is a readiness check:

curl https://dev.app.ingenee.ai/api/v1/channels/f27a91c3-4b6d-4e08-a5d2-9c1e3b7f0a64/distribution \
  -H "Authorization: Bearer $INGENEE_API_KEY"

{
  "channel": { "id": "f27a91c3-…", "name": "Ingenee Classic Cinema", "slug": "ingenee-classic-cinema" },
  "scheduledTitles": 188,
  "partners": [
    { "key": "roku_dpf", "name": "Roku Direct Publisher Feed", "selected": true, "entitled": true, "blockedTitles": 4,
      "requirements": ["IMDb id required", "16:9 hero ≥ 1280×720", "Runtime present"],
      "rejections": [ { "code": "…", "message": "…", "titles": ["…"] } ] }
  ],
  "canonicalFeeds": [ { "label": "EPG (XMLTV 1.3)", "apiPath": "/channels/…/epg.xml" }, { "label": "Schedule (JSON v1)", "apiPath": "/channels/…/schedule.json" } ]
}

Keys that are checked: roku_dpf, samsung_tvplus, jsonld. Other known keys (lg, vizio, pluto, xumo, amazon, plex) are listed but not validated. For each selected, checked distributor, rejections lists what its documented requirements would reject among the titles on this channel's schedule. apiPath values are shown without the /v1 prefix; call them as /v1/channels/{id}/epg.xml and /v1/channels/{id}/schedule.json. See EPG & exports.

Not yet availableCopy Anchor Link

• Per-channel delivery targets. Distributors are a list on the channel, plus the readiness check above.
• Releasing a single lock on its own, and the "shift following titles" and "replace what's there" placement options. place only drops into a gap, and move with locked: false releases a lock.
• Webhook events for generation. publish-succeeded is sent on publish.

EndpointsCopy Anchor Link