api-mapping

Map and analyze REST or GraphQL API endpoints with authentication and pagination details.

1.0k|158|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/vellum-ai/vellum-assistant --skill api-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-mapping
Source: https://github.com/vellum-ai/vellum-assistant/tree/main/skills/api-mapping
Command: npx skills add https://github.com/vellum-ai/vellum-assistant --skill api-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the discovery and analysis of API surfaces for web services, enabling teams to visualize endpoints, methods, auth patterns, and payload flows without manual scraping.

Core Features & Use Cases

  • Endpoints Discovery: identify all accessible API routes and HTTP methods across a target service.
  • Authentication & Pagination: surface auth mechanisms and pagination patterns to simplify integration work.
  • Actionable Insights: generate a structured map that can drive CLI tooling, type generation, or integration planning.

Quick Start

Run the api-mapping tool against a domain to auto-record its API surface and generate a JSON map.

Frequently Asked Questions about api-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I discover API endpoints and HTTP methods for a web service?

API discovery maps the surface of a web service by identifying accessible routes and HTTP methods. This tool automates that process, generating a structured JSON summary of endpoints grouped by resource type to simplify integration planning.

How do I map authentication and pagination patterns for a REST API integration?

Mapping authentication and pagination patterns is handled automatically during the API surface analysis. The tool inspects the target web service and outputs a structured JSON summary detailing the auth mechanisms and pagination flows required for your integration.

Can I use this API mapping tool for GraphQL services or only REST APIs?

API mapping supports both REST and GraphQL services. It analyzes the target web service to discover endpoints, methods, and payload relationships, outputting a structured map applicable to integration planning for either protocol.

What is the best way to generate a structured map of web service endpoints for architecture reviews?

Generating a structured map for architecture reviews is done by running the deterministic recording flow via a CLI. You execute the command against a domain to auto-record the API surface, which outputs a comprehensive JSON map of endpoints and payload relationships.

Does API discovery work with services like Notion and Figma for tooling generation?

API discovery works with services like Notion and Figma for tooling generation. The tool maps their API surfaces to reveal endpoints, auth patterns, and payload relationships, producing a structured output that can drive CLI tooling and type generation.

Do I need a CLI environment to analyze a web service API surface?

A CLI environment is required to run the deterministic recording flow and auto-generate the API JSON map. However, an optional manual mode is available if you need to analyze the web service API surface without the automated CLI recording process.