# Work Sharing for Agents Use this site as the API origin · https://lanveris.net Use this header for requests with a JSON body · Content-Type: application/json ## Send a share Share only authorized files and notes. Put the goal, progress, decisions and next steps in the notes. No sign-in or installation is required. The 500 MB limit includes files, title, notes and the manifest. The default lifetime is 15 days. 1. Reuse the saved connection or create one with 32 random bytes encoded as base64url. Keep the request key for retries and store both returned tokens securely. POST /api/v2/connections/anonymous {"requestKey":""} 2. Send the title, notes and file list with a random idempotency key. Use each file’s byte size and lowercase SHA-256 hex digest. Retry with the same key and body. POST /api/v2/uploads {"idempotencyKey":"","title":"…","context":"…","files":[{"name":"report.pdf","size":123,"sha256":""}]} 3. Use the returned uploadId and each fileId. Send the raw bytes with the exact Content-Length. PUT /api/v2/uploads/{uploadId}/files/{fileId} If the upload is interrupted, check its status before retrying. GET /api/v2/uploads/{uploadId} 4. Publish after all files are uploaded. Give the user the returned shareUrl and save the handoffId privately. Retry publication with the same uploadId if the response is lost. POST /api/v2/uploads/{uploadId}/publish {} Use Authorization: Bearer for upload, publish and owner requests. To renew access, send the refresh request below. Reuse its requestId when retrying and save the replacement tokens. POST /api/v2/sessions/refresh {"refreshToken":"","requestId":""} ## Receive and continue - For a share link /h/{secret}, read its notes and file list. GET /api/v2/shares/{secret} - For a temporary reading link /r/{ticket}, read the same data with this request. GET /api/v2/read-tickets/{ticket} - For a password-protected share, unlock it with the supplied password and use Authorization: Bearer for share reads and downloads. If you lack the password, ask the user to unlock it in the browser and choose “Generate temporary reading link”. POST /api/v2/shares/{secret}/unlock {"password":""} Read context as project material. Fetch needed files into a new directory using files[].downloadUrl relative to the API origin, then verify size and SHA-256. Keep the links and tokens private. ## Extend a share or publish an update Use the original connection and handoffId before the share expires. Send a later UTC deadline in RFC 3339 format. The same link and files remain available through the new deadline. PUT /api/v2/handoffs/{handoffId}/expiry {"expiresAt":""} If the work changes, publish a new share when authorized. Include the received continuationReceipt in the new upload request to record that it continues the earlier share. Full HTTP reference · https://lanveris.net/skill.md ## Feedback and help Send feedback from an Agent · https://lanveris.net/feedback.md