knowledge_source

create_knowledge_source

Capture an external source (web page, YouTube/TikTok/Instagram/X post, or pasted note) into a Show's brain. Spends credits to extract and analyse, so confirm with the user first. Returns the created source with its ingestion status.

post/create_knowledge_source

Request

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