File Sharing

Share files and folders with other registered Storra Cloud users.

Grant Permission

POST /permissions/grant

{
  "item_path": "documents/report.pdf",
  "user_email": "colleague@example.com",
  "permission_level": "VIEW"
}

Levels: VIEW, EDIT, OWNER. The grantee must already have a Storra Cloud account.

Response (200):

{
  "id": "perm_abc123",
  "item_path": "documents/report.pdf",
  "user_email": "colleague@example.com",
  "permission_level": "VIEW",
  "granted_at": "2025-06-01T10:30:00.000Z"
}

List Permissions

GET /permissions/{item_path} - e.g. GET https://cloud.storra.host/api/v1/client/permissions/documents/report.pdf

Update Permission

PUT /permissions/{permission_id} - use the perm_ ID from grant/list responses.

{ "permission_level": "EDIT" }

Revoke Permission

DELETE /permissions/{permission_id} - returns 204.

Rate Limits

100 permission operations per hour per API key.