{"files":{"SKILL.md":"---\nname: events-api\ndescription: \"Events API skill. Use when working with Events for api. Covers 5 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Events API\nAPI version: 1.2.0\n\n## Auth\nBearer bearer\n\n## Base URL\nhttps://events.1password.com\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /api/auth/introspect -- performs introspection of the provided bearer jwt token\n3. POST /api/v1/signinattempts -- create first signinattempt\n\n## Endpoints\n5 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Api\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /api/auth/introspect | Performs introspection of the provided Bearer JWT token |\n| GET | /api/v2/auth/introspect | Performs introspection of the provided Bearer JWT token |\n| POST | /api/v1/signinattempts | Retrieves events for both successful and failed attempts to sign into a 1Password account |\n| POST | /api/v1/itemusages | Retrieves events for each usage of an item stored in a shared vault within a 1Password account |\n| POST | /api/v1/auditevents | Retrieves audit events for actions performed by team members within a 1Password account |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all introspect?\" -> GET /api/auth/introspect\n- \"Create a signinattempt?\" -> POST /api/v1/signinattempts\n- \"Create a itemusage?\" -> POST /api/v1/itemusages\n- \"Create a auditevent?\" -> POST /api/v1/auditevents\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 Events API\n@base https://events.1password.com\n@version 1.2.0\n@auth Bearer bearer\n@endpoints 5\n@toc api(5)\n\n@endpoint GET /api/auth/introspect\n@desc Performs introspection of the provided Bearer JWT token\n@returns(200) {UUID: str, IssuedAt: str(date-time), Features: [str]} # Introspection object\n@errors {401: Unauthorized, 500: Internal Server Error}\n\n@endpoint GET /api/v2/auth/introspect\n@desc Performs introspection of the provided Bearer JWT token\n@returns(200) {uuid: str, issued_at: str(date-time), features: [str]} # Introspection v2 object\n@errors {401: Unauthorized, 500: Internal Server Error}\n\n@endpoint POST /api/v1/signinattempts\n@desc Retrieves events for both successful and failed attempts to sign into a 1Password account\n@returns(200) Sign-in attempts response object\n@errors {401: Unauthorized, 500: Internal Server Error}\n@example_request {\"cursor\":\"aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK\"}\n\n@endpoint POST /api/v1/itemusages\n@desc Retrieves events for each usage of an item stored in a shared vault within a 1Password account\n@returns(200) Item usages response object\n@errors {401: Unauthorized, 500: Internal Server Error}\n@example_request {\"cursor\":\"aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK\"}\n\n@endpoint POST /api/v1/auditevents\n@desc Retrieves audit events for actions performed by team members within a 1Password account\n@returns(200) Audit events response object\n@errors {401: Unauthorized, 500: Internal Server Error}\n@example_request {\"cursor\":\"aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK\"}\n\n@end\n"}}