endpoint-validator

Validate API endpoint responses, timing, and JSON keys from endpoints.json.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill endpoint-validator-notque
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: endpoint-validator
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/endpoint-validator
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill endpoint-validator-notque

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deterministic, automated validation of API endpoints to detect health issues before deployment.

Core Features & Use Cases

  • Discover definitions from a centralized endpoints.json and test each endpoint for status, timing, and optional JSON keys.
  • Produce structured, machine-readable results with CI-friendly exit codes suitable for automated pipelines.
  • Enforce safe defaults (read-only GET by default, explicit enablement for mutations) and report security header presence as warnings.

Quick Start

Create an endpoints.json in your project root with base_url and endpoints, then run the validator to execute checks and generate a report.

Frequently Asked Questions about endpoint-validator

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

FAQPage Schema
How do I automate API endpoint health checks in a CI/CD pipeline?

Automating API endpoint health checks in a CI/CD pipeline requires a validator that reads endpoint definitions, tests response status and timing, and outputs machine-readable results with CI-friendly exit codes. This approach gates deployments by detecting API health issues before release.

What is the best way to run deterministic API smoke tests before deployment?

Deterministic API smoke tests run by validating endpoint responses and timing against a centralized definitions file. This process uses a Discover-Validate-Report workflow to ensure consistent pre-deployment validation and outputs structured data suitable for automated pipelines.

How do I validate specific JSON keys in an API response during automated testing?

Validating specific JSON keys in an API response during automated testing is handled by configuring optional JSON key checks within your endpoint definitions. The validator tests each endpoint for status, timing, and the presence of those specified keys.

Can I test mutating API endpoints safely in an automated validation pipeline?

Testing mutating API endpoints safely in an automated validation pipeline is supported by enforcing read-only GET requests by default. Explicit enablement is required for mutations, ensuring safe defaults while reporting security header presence as warnings.

Do I need a specific file format to configure endpoint validation?

Configuring endpoint validation requires creating an endpoints.json file in your project root. This centralized file defines the base_url and the specific endpoints to test, allowing the validator to discover and execute checks automatically.