{"files":{"SKILL.md":"---\nname: facts-api\ndescription: \"Facts API skill. Use when working with Facts for fact. Covers 12 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Facts API\nAPI version: 1.5\n\n## Auth\nBearer bearer\n\n## Base URL\nhttps://api.fungenerators.com\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /fact -- get a fact belonging to the id.\n3. Explore available endpoints below\n\n## Endpoints\n12 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Fact\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /fact | Get a Fact belonging to the id. |\n| PUT | /fact | Add a Fact entry to the database (private collection). |\n| DELETE | /fact | Delete a Fact entry identified by the id. |\n| GET | /fact/fod/categories | Get the list of supported fact of the day categories. |\n| GET | /fact/fod | Get fact of the day for the given category. |\n| GET | /fact/random | Get a random Fact for a given category(optional) and subcategory(optional). |\n| GET | /fact/search | Search for random Fact which has the text in the query, for a given category(optional) and subcategory(optional). |\n| GET | /fact/categories | Get a random Fact. |\n| GET | /fact/numbers | Get a random fact about a number |\n| GET | /fact/onthisday/born | Returns a random ( famous/ relatively famous ) person born on a given day and month |\n| GET | /fact/onthisday/died | Returns a random ( famous/ relatively famous ) person died on a given day and month |\n| GET | /fact/onthisday/event | Returns a random ( famous/ relatively famous ) historic event on a given day and month |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all fact?\" -> GET /fact\n- \"List all categories?\" -> GET /fact/fod/categories\n- \"List all fod?\" -> GET /fact/fod\n- \"List all random?\" -> GET /fact/random\n- \"Search search?\" -> GET /fact/search\n- \"List all numbers?\" -> GET /fact/numbers\n- \"List all born?\" -> GET /fact/onthisday/born\n- \"List all died?\" -> GET /fact/onthisday/died\n- \"List all event?\" -> GET /fact/onthisday/event\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 Facts API\n@base https://api.fungenerators.com\n@version 1.5\n@auth Bearer bearer\n@endpoints 12\n@toc fact(12)\n\n@endpoint GET /fact\n@desc Get a Fact belonging to the id.\n@optional {id: str(string) # ID of the fact to fetch}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint PUT /fact\n@desc Add a Fact entry to the database (private collection).\n@required {fact: str(string) # Fact Text, category: str(string) # Category of the fact, subcategory: str(string) # Sub Category of the fact, tags: str(string) # Tags}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint DELETE /fact\n@desc Delete a Fact entry identified by the id.\n@required {id: str(string) # Fact ID}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/fod/categories\n@desc Get the list of supported fact of the day categories.\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/fod\n@desc Get fact of the day for the given category.\n@optional {category: str(string) # Category to get the fact of the day from. Must be one from the list returned from /fact/fod/categories}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/random\n@desc Get a random Fact for a given category(optional) and subcategory(optional).\n@optional {category: str(string) # Category to get the fact from, subcategory: str(string) # Sub Category to get the fact from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/search\n@desc Search for random Fact which has the text in the query, for a given category(optional) and subcategory(optional).\n@optional {query: str(string) # Text to search for in the facts, category: str(string) # Category to get the fact from, subcategory: str(string) # Sub Category to get the fact from}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/categories\n@desc Get a random Fact.\n@optional {start: int(integer) # start}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/numbers\n@desc Get a random fact about a number\n@required {number: int(integer) # Number value}\n@returns(200) 200 Success response\n@errors {401: 401 Unauthorized response}\n\n@endpoint GET /fact/onthisday/born\n@desc Returns a random ( famous/ relatively famous ) person born on a given day and month\n@optional {month: str(string) # Optional month (1-12). Defaults to current month, day: str(string) # Optional day of the month (1- 28/30/31 based on the month). Defaults to current day of the month.}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/onthisday/died\n@desc Returns a random ( famous/ relatively famous ) person died on a given day and month\n@optional {month: str(string) # Optional month (1-12). Defaults to current month, day: str(string) # Optional day of the month (1- 28/30/31 based on the month). Defaults to current day of the month.}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@endpoint GET /fact/onthisday/event\n@desc Returns a random ( famous/ relatively famous ) historic event on a given day and month\n@optional {month: str(string) # Optional month (1-12). Defaults to current month, day: str(string) # Optional day of the month (1- 28/30/31 based on the month). Defaults to current day of the month.}\n@returns(200) 200  response\n@errors {401: 401  response}\n\n@end\n"}}