All templates

Automated Hoppscotch Collection Documentation

Every Monday, WebRun opens Hoppscotch, reviews each collection in the team workspace for example requests, descriptions, and environment variables, logs any gaps to Airtable, and posts a Notion checklist so new collections do not sit half-documented and unusable for the rest of the team.

Runs on WebRun · Strict Lockdown policy
Every Monday at 9:00 AM WebRunorchestrates each step
1 Hoppscotch review collection completeness
2 Airtable log documentation gaps
3 Notion post the setup checklist
In short

How do I make sure Hoppscotch API collections stay documented?

WebRun reviews every collection in your team's Hoppscotch workspace each Monday, checking for request descriptions and environment variables, and logs any gaps to Airtable. It then posts a Notion checklist naming each incomplete collection and its owner, so a new API collection does not sit half-documented and unusable for the rest of the team.

  • Every collection gets checked for documentation gaps every week
  • New collections stop sitting half-set-up and hard to reuse
  • Owners see exactly what is missing instead of guessing

Built for API platform teams · backend engineering teams · integration teams · developer experience teams

Step by step

What does WebRun do on every run?

The exact actions WebRun takes, in order - in plain language, so you can adjust anything.

  1. WebRun signs in and gets to work

    Opens hoppscotch.io/login in a real browser with your saved login - no setup, no API keys.

  2. 1
    Hoppscotch - review collection completeness
    hoppscotch.io
    WebRun in Hoppscotch: review collection completeness
    WebRun opens Hoppscotch to review collection completeness.
    • Open the team workspace in Hoppscotch and review each collection
    • Check whether requests have descriptions and whether environment variables are set
    • Note which collections are missing documentation or environment setup

    Done when Every collection's documentation completeness is recorded.

  3. 2
    Airtable - log documentation gaps
    airtable.com
    WebRun in Airtable: log documentation gaps
    WebRun opens Airtable to log documentation gaps.
    • Open the API Collections base
    • Add or update a row per collection noting what is missing
    • Mark any collection completed since the last check as done

    Done when The Airtable base reflects the current documentation gap for every collection.

  4. 3
    Notion - post the setup checklist
    notion.so
    WebRun in Notion: post the setup checklist
    WebRun opens Notion to post the setup checklist.
    • Open the API team's Notion page
    • Post this week's checklist naming each incomplete collection and what it is missing
    • Assign it to the collection's owner if known

    Done when The team has this week's collection documentation checklist in Notion.

Run settings

How is each run configured?

Starting pageWhere Chrome opens at the start of each run
hoppscotch.io/login
ScheduleRuns automatically on this cadence
Every Monday at 9:00 AM
DeliveryHow each run's result reaches you
Documentation checklist · Notion
OutputWhat each run produces - A weekly Airtable log of documentation gaps per collection and a Notion checklist to close them.
Checklist
Setup & safety

Secure by default

Connect once, stays signed in

WebRun signs in once and keeps each session in a persistent environment, so every run picks up right where it left off.

Your credentials stay in your own private environment - WebRun never stores your passwords.
Strict Lockdown

Every action is checked against this policy before it runs.

Domains ALLOWLIST
Typed input ALLOW
Shell command BLOCK
File uploads BLOCK
Runs in a contained environment More on policies
Good to know

Questions, answered

Will WebRun write the missing documentation itself?

No. It only identifies what is missing and builds the checklist. Writing request descriptions and setting environment variables stays with the collection owner.

What counts as a documentation gap?

A collection missing request descriptions or environment variables that other requests in the workspace typically have, based on what your team has already set up elsewhere.

Does it check every collection or just new ones?

Every collection in the workspace each week, so an older collection that quietly went stale gets caught too, not just newly created ones.

Put this on autopilot.

Turn it on in minutes - or have our team set it up for you.