Revoke a file share
Revokes a share on a file. The grantee loses the file immediately — unless they still reach it through the connection or toolbox it came from, which a share revoke does not touch. Audited as file.share_revoked. A share id that does not belong to this file is 404 Share not found. Owner only: ownership is the gate, and there is no file:share permission. A caller who is not the owner gets 403 ("Only the owner…") whenever the file is visible to them in GET /file (an explicit share, or use on its source connection or toolbox, restricted or not), because they already know it exists; 404 otherwise, including a listed row whose access through a connection or toolbox has broken (can_open: false for a lapsed toolbox delegation or a deleted connection).
Request
- Base URL: https://api.elaichi.ai
- URL: https://api.elaichi.ai/file/{id}/share/{aclId}
- Auth: HTTP bearer
Path parameters
File id (file_…).
Share id (acl_…) from the share list.
Headers
Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.