v1

latestOpenAPI 3.0.42026-08-04342835917.6 KB
RankingFlowItem

Creates a new flow item for the specified flow.

post/flow/ranking/{flowId}/item

Path parameters

flowIdstring required

The ID of the flow to create the item in.

Request body

datasetIdstring required

The ID of the dataset to use for this flow item.

contextstring nullable

Optional context to provide additional ranking guidance.

timeToLiveInSecondsinteger nullable

Optional time-to-live in seconds before the flow item expires. Must be between 45 seconds and 1 hour; defaults to 4 minutes when omitted.

drainDurationInSecondsinteger nullable

Optional drain duration in seconds. When set, rapids are paused this many seconds before TTL expiry to allow in-flight responses to complete.

Response

OK

flowItemIdstring required

The ID of the created flow item.