media_asset

apply_media_asset

Apply a media asset as a cover or social image. Match the slot to the asset: a 16:9 YouTube thumbnail → episode_youtube_cover / show_youtube_cover; the square (1:1) podcast cover → episode_cover / show_cover; a clip image → clip. Never put a YouTube thumbnail in episode_cover/show_cover (it overwrites the podcast cover). Required: media_id, target (episode_cover|episode_youtube_cover|show_cover|show_youtube_cover|clip), target_id.

post/apply_media_asset

Request

  • Base URL: https://app.podmule.com/api/v1
  • URL: https://app.podmule.com/api/v1/apply_media_asset
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Stripe-style idempotency key. When present, repeat invocations within 24h with the same body return the original response; same key + different body returns 409 IDEMPOTENCY_KEY_REUSED.

X-PodMule-Dry-Run'true' | 'false'

When set to "true", routes the call to the capability's dryRun() method — same scope/precondition checks fire as the real handler, but persistence is skipped. The audit row is tagged result_status=dry_run.

Request body

unknown required

Response

Capability output wrapped in { data }.

dataunknown required

Changes

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