{"files":{"SKILL.md":"---\nname: auckland-museum-api\ndescription: \"Auckland Museum API skill. Use when working with Auckland Museum for search, id, sparql. Covers 6 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Auckland Museum API\nAPI version: 2.0.0\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://api.aucklandmuseum.com\n\n## Setup\n1. No auth setup needed\n2. GET /sparql -- verify access\n3. POST /search/{index}/{operation} -- create first search\n\n## Endpoints\n\n6 endpoints across 3 groups. See references/api-spec.lap for full details.\n\n### search\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /search/{index}/{operation} | Perform simple search queries over Auckland Museum Collections and Cenotaph data |\n| POST | /search/{index}/{operation} | Perform complex search queries over Auckland Museum Collections and Cenotaph data |\n\n### id\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /id/{identifier} | Explore details about a given subject node |\n| GET | /id/media/{path} | Retrieve media associated with Collections and Cenotaph subjects in Auckland Museum |\n\n### sparql\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /sparql | Auckland Museum SPARQL endpoint |\n| POST | /sparql | Auckland Museum SPARQL endpoint |\n\n## Common Questions\n\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Search search?\" -> GET /search/{index}/{operation}\n- \"Get id details?\" -> GET /id/{identifier}\n- \"Get media details?\" -> GET /id/media/{path}\n- \"Search sparql?\" -> GET /sparql\n- \"Create a sparql?\" -> POST /sparql\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints typically return the created/updated object\n\n## CLI\n\n```bash\n# Update this spec to the latest version\nnpx @lap-platform/lapsh get auckland-museum-api -o references/api-spec.lap\n\n# Search for related APIs\nnpx @lap-platform/lapsh search auckland-museum-api\n```\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 Auckland Museum API\n@base https://api.aucklandmuseum.com\n@version 2.0.0\n@endpoints 6\n@toc search(2), id(2), sparql(2)\n\n@group search\n@endpoint GET /search/{index}/{operation}\n@desc Perform simple search queries over Auckland Museum Collections and Cenotaph data\n@required {index: any # search index name Possible values: * `collectionsonline` * `cenotaph`, operation: any # One of the supported elasticsearch operations like `_search` or `_suggest`}\n@optional {q: any # One of the supported elasticsearch query parameter values for key `q`}\n@returns(200) search results found\n@errors {400: bad request, 404: not found}\n\n@endpoint POST /search/{index}/{operation}\n@desc Perform complex search queries over Auckland Museum Collections and Cenotaph data\n@required {index: any # search index name Possible values: * `collectionsonline` * `cenotaph`, operation: any # One of the supported elasticsearch operations like `_search` or `_suggest`}\n@optional {body: map # body}\n@returns(200) search results found\n@errors {400: bad request, 404: not found}\n\n@endgroup\n\n@group id\n@endpoint GET /id/{identifier}\n@desc Explore details about a given subject node\n@required {identifier: any # The identifier path of the `subject` you're looking for}\n@returns(200) `subject` found\n@errors {404: `subject` not found}\n\n@endpoint GET /id/media/{path}\n@desc Retrieve media associated with Collections and Cenotaph subjects in Auckland Museum\n@required {path: any # The media `identifier`}\n@optional {rendering: any # The desired media `rendering`  Possible values: * `original.jpg` * `original.pdf` * `thumbnail.jpg` (fixed with 70px) * `standard.jpg` (fixed width 440px and height 440px) * `preview.jpg` (fixed height 100px)}\n@returns(200) `media` found\n@errors {404: `media` not found}\n\n@endgroup\n\n@group sparql\n@endpoint GET /sparql\n@desc Auckland Museum SPARQL endpoint\n@required {query: any # sparql query}\n@optional {callback: any # The [JSON-P](http://json-p.org/) callback parameter, infer: any # Whether to get inferred results in the response}\n@returns(200) success\n\n@endpoint POST /sparql\n@desc Auckland Museum SPARQL endpoint\n@required {query: any # sparql query}\n@optional {infer: any # Whether to get inferred results in the response}\n@returns(200) success\n\n@endgroup\n\n@end\n"}}