social_media_from_url

import_social_media_from_url

Create or update a clip and queue a background video import from a direct URL or Descript share URL. For requests like "add this link to episode 2 social", first find the episode with search_episodes, then call target=new_clip with episode_id. Descript links save transcript text and start clip drafting/processing even while video render is not ready.

post/import_social_media_from_url

Request

  • Base URL: https://app.podmule.com/api/v1
  • URL: https://app.podmule.com/api/v1/import_social_media_from_url
  • 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.