{"files":{"SKILL.md":"---\nname: random-riddles-api\ndescription: \"Random Riddles API skill. Use when working with Random Riddles for riddle. Covers 6 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Random Riddles API\nAPI version: 1.5\n\n## Auth\nApiKey X-Fungenerators-Api-Secret in header\n\n## Base URL\nhttps://api.fungenerators.com\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /riddle -- get a riddle entry for a given id. retrieves a riddle question and answer based on the id.\n3. POST /riddle -- create first riddle\n\n## Endpoints\n6 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Riddle\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /riddle | Get a Riddle entry for a given id. Retrieves a riddle question and answer based on the id. |\n| POST | /riddle | Create a random Riddle entry. Same as 'PUT' but can be used when some of the client libraries don't support 'PUT'. |\n| PUT | /riddle | Create a random Riddle entry. |\n| DELETE | /riddle | Create a random Riddle entry. |\n| GET | /riddle/random | Get a random riddle for a given category(optional) |\n| GET | /riddle/search | Search for random riddle which has the text in the query, for a given category(optional). |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all riddle?\" -> GET /riddle\n- \"Create a riddle?\" -> POST /riddle\n- \"List all random?\" -> GET /riddle/random\n- \"Search search?\" -> GET /riddle/search\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Random Riddles API\n@base https://api.fungenerators.com\n@version 1.5\n@auth ApiKey X-Fungenerators-Api-Secret in header\n@endpoints 6\n@toc riddle(6)\n\n@endpoint GET /riddle\n@desc Get a Riddle entry for a given id. Retrieves a riddle question and answer based on the id.\n@optional {id: str(string) # ID of the riddle to fetch}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint POST /riddle\n@desc Create a random Riddle entry. Same as 'PUT' but can be used when some of the client libraries don't support 'PUT'.\n@required {question: str(string) # Riddle Question, category: str(string) # Category of the riddle, answer: str(string) # Answer(s) to the riddle question}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint PUT /riddle\n@desc Create a random Riddle entry.\n@required {question: str(string) # Riddle Question, category: str(string) # Category of the riddle, answer: str(string) # Answer(s) to the riddle question}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint DELETE /riddle\n@desc Create a random Riddle entry.\n@required {id: str(string) # Riddle ID}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /riddle/random\n@desc Get a random riddle for a given category(optional)\n@optional {category: str(string) # Category to get the riddle from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /riddle/search\n@desc Search for random riddle which has the text in the query, for a given category(optional).\n@optional {query: str(string) # Text to search for in the riddle, category: str(string) # Category to get the riddle from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@end\n"}}