Create a public share link

POST 
/api/v1/buckets/:bucketId/shares

Requires owner role on this bucket. type determines the scope: files (specific file_ids), folder (a single folder_id, whole subtree), or bucket (entire bucket).

Request

Responses

201

Created share

400

Validation error

401

Not authenticated. Note: a missing or invalid token is rejected with 403 FORBIDDEN (not 401); 401 is returned when the token's session has been revoked (SESSION_REVOKED).

403

Missing/invalid token, or the caller's role/group is below the required minimum (FORBIDDEN)

404

Bucket, folder, or one of the files not found (BUCKET_NOT_FOUND, FOLDER_NOT_FOUND, FILE_NOT_FOUND)