| name | api-validation |
| description | Use when user asks to check API responses, validate request/response contracts, compare API behavior against a spec, or detect schema drift. |
Kaboom API Validation
Use this skill when endpoint behavior, payload shape, or status handling is in question.
Inputs To Request
- Operation(s) or endpoint(s)
- Expected status codes and response shape
- Auth/session expectations
Workflow
-
Define checks:
List each operation with expected request and response constraints.
-
Collect traffic:
Use observe(network_waterfall) and observe(network_bodies) for matching requests.
-
Validate contracts:
Run analyze(api_validation) for each operation and capture mismatches.
-
Check auth and headers:
Confirm required cookies/tokens/headers and error-path behavior.
-
Classify mismatch type:
Schema drift, status drift, auth failure, routing mismatch, or serialization issue.
-
Recommend minimum corrective change:
Prefer server/client contract alignment with explicit tests.
Output Contract
operations_checked
mismatches
risk_level
recommended_fix
follow_up_tests