{"files":{"SKILL.md":"---\nname: groov-view-public-api\ndescription: \"groov View Public API skill. Use when working with groov View Public for info, whoami, data-store. Covers 10 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# groov View Public API\nAPI version: R4.2a\n\n## Auth\nApiKey api_key in query\n\n## Base URL\nNot specified.\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /info -- get information about groov view. no authorization required.\n3. POST /v1/data-store/read -- create first read\n\n## Endpoints\n10 endpoints across 4 groups. See references/api-spec.lap for full details.\n\n### Info\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /info | Get information about groov View. No authorization required. |\n\n### Whoami\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /whoami | Get information about the user you are authenticated as. Authorized for admins, editors, operators, and kiosk. |\n\n### Data-store\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/data-store/devices | List devices available in the data store. Authorized for admins and editors. |\n| GET | /v1/data-store/devices/{id}/tags | List tags of the given device. Authorized for admins and editors. |\n| GET | /v1/data-store/tags | List all data store tags defined in the project. Authorized for admins and editors. |\n| POST | /v1/data-store/read | Read selected tags from the data store. Authorized for admins and editors. |\n| GET | /v1/data-store/read/{id} | Read the current value of a single tag. Authorized for admins and editors. |\n| POST | /v1/data-store/write/{id} | Writes a new value to the given tag. Authorized for admins and editors. |\n\n### Logging\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/logging/groovLogs.txt | Downloads the complete groov View log. Added in groov View R4.2a. |\n| GET | /v1/logging/groovLogs.json | Downloads the complete groov View log in JSON format. Added in groov View R4.2a. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all info?\" -> GET /info\n- \"List all whoami?\" -> GET /whoami\n- \"List all devices?\" -> GET /v1/data-store/devices\n- \"List all tags?\" -> GET /v1/data-store/devices/{id}/tags\n- \"Create a read?\" -> POST /v1/data-store/read\n- \"Get read details?\" -> GET /v1/data-store/read/{id}\n- \"List all groovLogs.txt?\" -> GET /v1/logging/groovLogs.txt\n- \"List all groovLogs.json?\" -> GET /v1/logging/groovLogs.json\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\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 groov View Public API\n@version R4.2a\n@auth ApiKey api_key in query\n@endpoints 10\n@toc info(1), whoami(1), data-store(6), logging(2)\n\n@group info\n@endpoint GET /info\n@desc Get information about groov View. No authorization required.\n@returns(200) OK\n\n@endgroup\n\n@group whoami\n@endpoint GET /whoami\n@desc Get information about the user you are authenticated as. Authorized for admins, editors, operators, and kiosk.\n@returns(200) OK\n\n@endgroup\n\n@group data-store\n@endpoint GET /v1/data-store/devices\n@desc List devices available in the data store. Authorized for admins and editors.\n@returns(200) OK\n\n@endpoint GET /v1/data-store/devices/{id}/tags\n@desc List tags of the given device. Authorized for admins and editors.\n@returns(200) OK\n\n@endpoint GET /v1/data-store/tags\n@desc List all data store tags defined in the project. Authorized for admins and editors.\n@returns(200) OK\n\n@endpoint POST /v1/data-store/read\n@desc Read selected tags from the data store. Authorized for admins and editors.\n@returns(200) OK\n\n@endpoint GET /v1/data-store/read/{id}\n@desc Read the current value of a single tag. Authorized for admins and editors.\n@returns(200) OK\n\n@endpoint POST /v1/data-store/write/{id}\n@desc Writes a new value to the given tag. Authorized for admins and editors.\n@returns(200) OK\n\n@endgroup\n\n@group logging\n@endpoint GET /v1/logging/groovLogs.txt\n@desc Downloads the complete groov View log. Added in groov View R4.2a.\n@optional {minimum-log-level: any # How verbose the log should be., last-timestamp: any # The earliest time to include in the log. Value is milliseconds since January 1, 1970 UTC., filter: any # Optional string to search for in the log.}\n@returns(200) Downloaded log file.\n\n@endpoint GET /v1/logging/groovLogs.json\n@desc Downloads the complete groov View log in JSON format. Added in groov View R4.2a.\n@optional {minimum-log-level: any # How verbose the log should be., last-timestamp: any # The earliest time to include in the log. Value is milliseconds since January 1, 1970 UTC., filter: any # Optional string to search for in the log.}\n@returns(200) Downloaded log file.\n\n@endgroup\n\n@end\n"}}