{"note":"OpenAPI conversion -- returning structured metadata","name":"1password-local-connect","description":"1Password Connect","version":"1.5.7","base_url":"http://localhost:8080/v1","endpoints":15,"raw":"@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"}