{"files":{"SKILL.md":"---\nname: 1password-connect\ndescription: \"1Password Connect API skill. Use when working with 1Password Connect for activity, vaults, heartbeat. Covers 15 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# 1Password Connect\nAPI version: 1.5.7\n\n## Auth\nBearer bearer\n\n## Base URL\nhttp://localhost:8080/v1\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /activity -- retrieve a list of api requests that have been made.\n3. POST /vaults/{vaultUuid}/items -- create first item\n\n## Endpoints\n15 endpoints across 5 groups. See references/api-spec.lap for full details.\n\n### Activity\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /activity | Retrieve a list of API Requests that have been made. |\n\n### Vaults\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /vaults | Get all Vaults |\n| GET | /vaults/{vaultUuid} | Get Vault details and metadata |\n| GET | /vaults/{vaultUuid}/items | Get all items for inside a Vault |\n| POST | /vaults/{vaultUuid}/items | Create a new Item |\n| GET | /vaults/{vaultUuid}/items/{itemUuid} | Get the details of an Item |\n| PUT | /vaults/{vaultUuid}/items/{itemUuid} | Update an Item |\n| DELETE | /vaults/{vaultUuid}/items/{itemUuid} | Delete an Item |\n| PATCH | /vaults/{vaultUuid}/items/{itemUuid} | Update a subset of Item attributes |\n| GET | /vaults/{vaultUuid}/items/{itemUuid}/files | Get all the files inside an Item |\n| GET | /vaults/{vaultUuid}/items/{itemUuid}/files/{fileUuid} | Get the details of a File |\n| GET | /vaults/{vaultUuid}/items/{itemUuid}/files/{fileUuid}/content | Get the content of a File |\n\n### Heartbeat\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /heartbeat | Ping the server for liveness |\n\n### Health\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /health | Get state of the server and its dependencies. |\n\n### Metrics\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /metrics | Query server for exposed Prometheus metrics |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all activity?\" -> GET /activity\n- \"List all vaults?\" -> GET /vaults\n- \"Get vault details?\" -> GET /vaults/{vaultUuid}\n- \"List all items?\" -> GET /vaults/{vaultUuid}/items\n- \"Create a item?\" -> POST /vaults/{vaultUuid}/items\n- \"Get item details?\" -> GET /vaults/{vaultUuid}/items/{itemUuid}\n- \"Update a item?\" -> PUT /vaults/{vaultUuid}/items/{itemUuid}\n- \"Delete a item?\" -> DELETE /vaults/{vaultUuid}/items/{itemUuid}\n- \"Partially update a item?\" -> PATCH /vaults/{vaultUuid}/items/{itemUuid}\n- \"List all files?\" -> GET /vaults/{vaultUuid}/items/{itemUuid}/files\n- \"Get file details?\" -> GET /vaults/{vaultUuid}/items/{itemUuid}/files/{fileUuid}\n- \"List all content?\" -> GET /vaults/{vaultUuid}/items/{itemUuid}/files/{fileUuid}/content\n- \"List all heartbeat?\" -> GET /heartbeat\n- \"List all health?\" -> GET /health\n- \"List all metrics?\" -> GET /metrics\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- Paginated endpoints accept limit/offset or cursor parameters\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 1Password Connect\n@base http://localhost:8080/v1\n@version 1.5.7\n@auth Bearer bearer\n@endpoints 15\n@toc activity(1), vaults(11), heartbeat(1), health(1), metrics(1)\n\n@group activity\n@endpoint GET /activity\n@desc Retrieve a list of API Requests that have been made.\n@optional {limit: int=50 # How many API Events should be retrieved in a single request., offset: int=0 # How far into the collection of API Events should the response start}\n@returns(200) OK\n@errors {401: Invalid or missing token}\n\n@endgroup\n\n@group vaults\n@endpoint GET /vaults\n@desc Get all Vaults\n@optional {filter: str # Filter the Vault collection based on Vault name using SCIM eq filter}\n@returns(200) OK\n@errors {401: Invalid or missing token}\n\n@endpoint GET /vaults/{vaultUuid}\n@desc Get Vault details and metadata\n@required {vaultUuid: str # The UUID of the Vault to fetch Items from}\n@returns(200) {id: str, name: str, description: str, attributeVersion: int, contentVersion: int, items: int, type: str, createdAt: str(date-time), updatedAt: str(date-time)} # OK\n@errors {401: Invalid or missing token, 403: Unauthorized access, 404: Vault not found}\n\n@endpoint GET /vaults/{vaultUuid}/items\n@desc Get all items for inside a Vault\n@required {vaultUuid: str # The UUID of the Vault to fetch Items from}\n@optional {filter: str # Filter the Item collection based on Item name using SCIM eq filter}\n@returns(200) OK\n@errors {401: Invalid or missing token, 404: Vault not found}\n\n@endpoint POST /vaults/{vaultUuid}/items\n@desc Create a new Item\n@required {vaultUuid: str # The UUID of the Vault to create an Item in}\n@returns(200) OK\n@errors {400: Unable to create item due to invalid input, 401: Invalid or missing token, 403: Unauthorized access, 404: Item not found}\n\n@endpoint GET /vaults/{vaultUuid}/items/{itemUuid}\n@desc Get the details of an Item\n@required {vaultUuid: str # The UUID of the Vault to fetch Item from, itemUuid: str # The UUID of the Item to fetch}\n@returns(200) OK\n@errors {401: Invalid or missing token, 403: Unauthorized access, 404: Item not found}\n\n@endpoint PUT /vaults/{vaultUuid}/items/{itemUuid}\n@desc Update an Item\n@required {vaultUuid: str # The UUID of the Item's Vault, itemUuid: str # The UUID of the Item to update}\n@returns(200) OK\n@errors {400: Unable to create item due to invalid input, 401: Invalid or missing token, 403: Unauthorized access, 404: Item not found}\n\n@endpoint DELETE /vaults/{vaultUuid}/items/{itemUuid}\n@desc Delete an Item\n@required {vaultUuid: str # The UUID of the Vault the item is in, itemUuid: str # The UUID of the Item to update}\n@returns(204) Successfully deleted an item\n@errors {401: Invalid or missing token, 403: Unauthorized access, 404: Item not found}\n\n@endpoint PATCH /vaults/{vaultUuid}/items/{itemUuid}\n@desc Update a subset of Item attributes\n@required {vaultUuid: str # The UUID of the Vault the item is in, itemUuid: str # The UUID of the Item to update}\n@returns(200) OK - Item updated. If no Patch operations were provided, Item is unmodified.\n@errors {401: Invalid or missing token, 403: Unauthorized access, 404: Item not found}\n@example_request [{\"op\":\"replace\",\"path\":\"/\",\"value\":{\"title\":\"New Title\",\"favorite\":true,\"tags\":[\"tag1\",\"tag2\"],\"...\":\"Any attr from FullItem schema\"}}]\n\n@endpoint GET /vaults/{vaultUuid}/items/{itemUuid}/files\n@desc Get all the files inside an Item\n@required {vaultUuid: str(uuid) # The UUID of the Vault to fetch Items from, itemUuid: str(uuid) # The UUID of the Item to fetch files from}\n@optional {inline_files: bool # Tells server to return the base64-encoded file contents in the response.}\n@returns(200) OK\n@errors {401: Invalid or missing token, 404: Item not found, 413: File content too large to display}\n\n@endpoint GET /vaults/{vaultUuid}/items/{itemUuid}/files/{fileUuid}\n@desc Get the details of a File\n@required {vaultUuid: str(uuid) # The UUID of the Vault to fetch Item from, itemUuid: str(uuid) # The UUID of the Item to fetch File from, fileUuid: str(uuid) # The UUID of the File to fetch}\n@optional {inline_files: bool # Tells server to return the base64-encoded file contents in the response.}\n@returns(200) {id: str, name: str, size: int, content_path: str, section: map{id: str}, content: str(byte)} # OK\n@errors {401: Invalid or missing token, 403: Unauthorized access, 404: File not found, 413: File content too large to display}\n\n@endpoint GET /vaults/{vaultUuid}/items/{itemUuid}/files/{fileUuid}/content\n@desc Get the content of a File\n@returns(200) Success\n@errors {401: Invalid or missing token, 404: File not found}\n\n@endgroup\n\n@group heartbeat\n@endpoint GET /heartbeat\n@desc Ping the server for liveness\n@returns(200) OK\n\n@endgroup\n\n@group health\n@endpoint GET /health\n@desc Get state of the server and its dependencies.\n@returns(200) {name: str, version: str, dependencies: [map]} # OK\n\n@endgroup\n\n@group metrics\n@endpoint GET /metrics\n@desc Query server for exposed Prometheus metrics\n@returns(200) Successfully returned Prometheus metrics\n\n@endgroup\n\n@end\n"}}