jockey_add_media
ChatGPTAdd one or more videos/images to a knowledge store in a single call. Each item in `
items provides exactly one of: - source: a media URL the platform fetches server-side — a direct-download link reachable from the public internet, up to 4 GB each. YouTube, TikTok, and Instagram links to one video or post are also accepted; profile, channel, and playlist links are not. Google Drive URLs are not fetched; use an available Drive data connector. Or - asset_id: an asset you already hold (e.g. from a prior add), registered directly into this store, no re-upload. Plus optional asset_type (video/image) and metadata. Prefer one batched call over many single-item calls. If the user's files are only on their own device (no public URL, no existing asset_id), or they want to import from Google Drive, use jockey_request_upload_link instead. Each input is registered as a KS item (a source is first created as an asset, then waited on until it finishes processing) — reported per item via an outcome field (branch on it, not on error prose): - added: registered (item_id set; poll jockey_list_knowledge_store_items with item_ids until ready before querying). - asset_pending: the asset is still being processed and is not yet registered (asset_id set). Retry jockey_add_media with that asset_id after a short wait — an immediate retry may defer again while it is still processing. Expected deferral, not a failure. - registration_pending: the asset reached ready and registration was attempted but did not resolve in time (asset_id set). Retry jockey_add_media with that asset_id NOW — the asset is ready and re-registering is idempotent (usually succeeds immediately). Expected deferral, not a failure. - registration_failed: registration rejected — see error_code / retriable. - asset_failed: the media failed processing (terminal). - rejected: the source could not be turned into an asset. When retriable is true, re-add the same input. Otherwise a re-add of the same URL won't change the result: correct a fixable URL problem (e.g. an expired link) first; an unsupported source or media that could not be retrieved (e.g. private/removed) needs a different source. Each result echoes its input_index (0-based) and source (the URL or asset_id given) so every outcome ties back to the exact input. counts is the authoritative per-outcome tally and summary` a one-line recap. One bad input does not fail the batch. Required scopes: jockey:read, jockey:write, jockey:ingest.





