About graphql-and-hidden-parameters
A security-testing skill for agents and testers examining GraphQL and REST APIs. It focuses on schema discovery, undocumented parameters, and the security effects of batching.
Key features
- 01GraphQL schema discovery
- 02Error and field-suggestion probes
- 03Undocumented parameter checks
- 04Batching security tests
- 05Routes follow-up testing
Use cases
- 01Map a restricted GraphQL schema
- 02Check authorization on undocumented fields
- 03Test batching effects on auth or rate limits
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/graphql-and-hidden-parametersin Claude Code to confirm it loaded.
Details
From the project READMESKILL: GraphQL and Hidden Parameters — Introspection, Batching, and Undocumented Fields
AI LOAD INSTRUCTION: Use this skill when GraphQL exists or when REST documentation suggests optional, deprecated, or undocumented fields. Focus on schema discovery, hidden parameter abuse, and batching as a force multiplier.
1. GRAPHQL FIRST PASS
query { __typename }
query {
__schema {
types { name }
}
}
If introspection is restricted, continue with:
- field suggestions and error-based discovery
- known type probes like
__type(name: "User") - JS and mobile bundle route extraction
2. HIGH-VALUE GRAPHQL TESTS
| Theme | Example |
|---|---|
| IDOR | user(id: "victim") |
| batching | array of login or object fetch operations |
| hidden fields | admin-only fields exposed in type definitions |
| nested authz gaps | related object fields with weaker checks |
3. HIDDEN PARAMETER DISCOVERY
Look for:
- fields present in admin docs but not public docs
additionalPropertiesor permissive schemas- frontend code using richer request bodies than visible UI controls
- mobile endpoints carrying role, org, feature-flag, or internal filter fields
4. NEXT ROUTING
- If hidden fields affect privilege: api authorization and bola
- If GraphQL batching changes auth or rate behavior: api auth and jwt abuse
- If endpoint discovery is incomplete: api recon and docs
Comments
Markdown supported