Schedules

Suggest a schedule

POST
/v1/channels/{id}/schedule/generate

AI plans dayparts and blocks, then a deterministic packer fits titles to the clock across the channel's horizon. The build becomes a new schedule version. If the channel has auto-publish on and nothing changed in its settings since the last publish, the build is published; otherwise it waits as a draft for publishSchedule.

Note: Runs for up to a few minutes on long horizons. Send Prefer: respond-async to get 202 at once and poll GET /v1/requests/{id}.

Scope: schedules:write

Authorization

apiKey
headerAuthorizationBearer <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.

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Any unique string. A retry with the same key and the same request gets the first answer back instead of running twice (kept 24 hours).

Lengthlength <= 255
Prefer?"respond-async"

respond-async runs the call in the background: the answer is 202 with a request id; poll GET /v1/requests/{id}.

Value in"respond-async"

Request Body

application/json
  1. body
startDate?string
Match^\d{4}-\d{2}-\d{2}$

Response Body

OK

application/json
  1. response
[key: string]?any
Example Request
curl -X POST 'https://dev.app.ingenee.ai/api/v1/channels/string/schedule/generate' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{}