agent

Agent Channel New

New videos on a YouTube channel since the caller's cursor. Pay-per-call via x402 (no account/key). Stateless: we hold no per-caller watch state — the agent supplies its own cursor (a video id or timestamp) and we answer from YouTube's public channel feed (youtube_feed). No jobs-ledger row (a poll has no video to attach one to), but it does write an x402_payments row (see below) so this SKU isn't invisible in Postgres; wallet-level reconciliation also logs payer/amount via _register_reconciliation_hooks. Charged only on success — an unresolvable channel or a malformed cursor is never charged.

post/v1/channel/new

Request

  • Base URL: https://api.sumvid.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.sumvid.app/v1/channel/new
  • Auth: none declared

Request body

channelstring required
since_video_idstring nullable
sincestring date-time nullable

Response

Successful Response

channel_idstring required
channel_titlestring nullable
newest_video_idstring nullable
cursor_foundboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.