Hoppscotch API Documentation with agent-hoppscotch

Core workflow

1. Check config: agent-hoppscotch auth status
2. If not configured, ask user for:
   • Hoppscotch GraphQL endpoint URL
   • Session cookie (from browser DevTools → Application → Cookies)
3. Configure: Set endpoint, cookie, and defaults
4. Work: Create/update collections and requests

Configuration (only if status shows "Not configured")

# Step 1: Set endpoint (ask user for their Hoppscotch URL)
agent-hoppscotch auth set-endpoint "<user_provided_url>/graphql"

# Step 2: Set cookie (ask user to copy from browser)
agent-hoppscotch auth set-cookie "<cookie_string>"

# Step 3: List teams and ask user to select
agent-hoppscotch team list
agent-hoppscotch auth set-default --team <selected_team_id>

# Step 4: List collections and ask user to select default
agent-hoppscotch collection list
agent-hoppscotch auth set-default --collection <selected_collection_id>

Commands

Auth

agent-hoppscotch auth status                        # Show configuration
agent-hoppscotch auth set-endpoint "<url>"          # Set GraphQL endpoint
agent-hoppscotch auth set-cookie "<cookie>"         # Set session cookie
agent-hoppscotch auth set-default --team <id> --collection <id>  # Set defaults
agent-hoppscotch auth clear                         # Remove all credentials

Team

agent-hoppscotch team list                          # List all teams
agent-hoppscotch team find "<term>"                 # Search by name
agent-hoppscotch team get <id>                      # Get team details

Collection

agent-hoppscotch collection list                    # List root collections (uses default team)
agent-hoppscotch collection list --team <id>        # List for specific team
agent-hoppscotch collection list --parent <id>      # List child collections
agent-hoppscotch collection find "<term>"           # Search (includes children)
agent-hoppscotch collection get...