Dify

Dify lets you register external APIs as Custom Tools that any agent or workflow can call. Just point it at Thunderbit's OpenAPI spec.

Add the tool

1. Tools → Custom → Create custom tool
2. Schema → paste the Thunderbit OpenAPI spec (or just the /distill slice below)
3. Authentication → API Key in header:
   • Key: Authorization
   • Value: Bearer YOUR_API_KEY

Minimal schema (just /distill)

openapi: 3.0.0
info: { title: Thunderbit, version: "1" }
servers:
  - url: https://openapi.thunderbit.com/openapi/v1
paths:
  /distill:
    post:
      operationId: distill
      summary: Fetch a URL and return clean Markdown
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [url]
              properties:
                url:        { type: string, format: uri }
                renderMode: { type: string, enum: [basic, advanced], default: basic }
      responses:
        "200":
          description: OK

Use in an Agent

In Dify's Agent or Chatflow, drop the distill tool into the toolset. Prompt example:

"When the user asks about a URL, call distill and answer based on the returned Markdown."

Use in a Workflow

For RAG-style ingestion: Knowledge node ← distill.data.markdown ← Start node URL input. For batch, swap in /batch/distill and add a Loop node that polls /batch/{jobId} until COMPLETED.

Related

• API Reference
• RAG Knowledge Base
• Flowise