Import a photo or video into Hive
upload_media_from_urlIdempotent
Import one attached photo or video, or a public media URL, into this workspace’s Hive Asset Library so a post can use it. Supply exactly one of file or url. This publishes nothing. Private network addresses, insecure redirects, files over 100 MB and unsupported types are refused.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The public link to the photo or video. | |
| file | No | ||
| title | No | A name for the Asset Library item. | |
| altText | No | Accessibility text saved with the item. | |
| folderId | No | An Asset Library folder to file it in. | |
| channelGroupId | No | An accessible channel group from read_media_library. Required when the library saves assets per group. | |
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |