{"files":{"SKILL.md":"---\nname: annotations-api\ndescription: \"Annotations API skill. Use when working with Annotations for projects. Covers 7 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Annotations API\nAPI version: 1.0.0\n\n## Auth\nNo authentication required.\n\n## Base URL\nNot specified.\n\n## Setup\n1. No auth setup needed\n2. GET /projects/{projectId}/annotations -- list annotations\n3. POST /projects/{projectId}/annotations -- create first annotation\n\n## Endpoints\n7 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Projects\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /projects/{projectId}/annotations | List Annotations |\n| POST | /projects/{projectId}/annotations | Create Annotations |\n| GET | /projects/{projectId}/annotations/{annotationId} | Get Annotation |\n| PATCH | /projects/{projectId}/annotations/{annotationId} | Patch Annotation |\n| DELETE | /projects/{projectId}/annotations/{annotationId} | Delete Annotation |\n| GET | /projects/{projectId}/annotations/tags | Get Annotation Tags |\n| POST | /projects/{projectId}/annotations/tags | Create Annotation Tag |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all annotations?\" -> GET /projects/{projectId}/annotations\n- \"Create a annotation?\" -> POST /projects/{projectId}/annotations\n- \"Get annotation details?\" -> GET /projects/{projectId}/annotations/{annotationId}\n- \"Partially update a annotation?\" -> PATCH /projects/{projectId}/annotations/{annotationId}\n- \"Delete a annotation?\" -> DELETE /projects/{projectId}/annotations/{annotationId}\n- \"List all tags?\" -> GET /projects/{projectId}/annotations/tags\n- \"Create a tag?\" -> POST /projects/{projectId}/annotations/tags\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 Annotations API\n@version 1.0.0\n@endpoints 7\n@toc projects(7)\n\n@endpoint GET /projects/{projectId}/annotations\n@desc List Annotations\n@returns(200) {status: str, results: [map]} # Success\n@errors {401, 403}\n\n@endpoint POST /projects/{projectId}/annotations\n@desc Create Annotations\n@optional {date: str # A string representation of a date in \"YYYY-MM-DD HH:mm:ss\" format, description: str # The text that will be shown when looking at the annotation, tags: [num] # The ids of the tags to be added to the annotation}\n@returns(201) {status: str, results: map{date: str, description: str, id: num, user: map{id: num, first_name: str, last_name: str}, tags: [map]}} # Success\n@errors {401, 403}\n\n@endpoint GET /projects/{projectId}/annotations/{annotationId}\n@desc Get Annotation\n@returns(200) {status: str, results: map{date: str, description: str, id: num, user: map{id: num, first_name: str, last_name: str}, tags: [map]}} # Success\n@errors {401, 403}\n\n@endpoint PATCH /projects/{projectId}/annotations/{annotationId}\n@desc Patch Annotation\n@optional {description: str # The text that will be shown when looking at the annotation, tags: [num] # The ids of the tags to be added to the annotation}\n@returns(200) {status: str, results: map{date: str, description: str, id: num, user: map{id: num, first_name: str, last_name: str}, tags: [map]}} # Success\n@errors {401, 403}\n\n@endpoint DELETE /projects/{projectId}/annotations/{annotationId}\n@desc Delete Annotation\n@returns(200) {status: str, results: map{id: num}} # Success\n@errors {401, 403}\n\n@endpoint GET /projects/{projectId}/annotations/tags\n@desc Get Annotation Tags\n@returns(200) Success\n@errors {401, 403}\n\n@endpoint POST /projects/{projectId}/annotations/tags\n@desc Create Annotation Tag\n@optional {name: str # The text that will be shown when the tag is added to an annotation}\n@returns(200) {id: num, name: str, project_id: num, has_annotations: bool} # Success\n@errors {401, 403}\n\n@end\n"}}