This API endpoint allows users to share a file by generating a unique, shareable link for the specified file.

Request

POST http://localhost:3000/files/:id/share

Replace :id with the file ID you want to share.

Headers

• Authorization: Bearer <access_token>

Example

cURL

curl --location --request POST '<http://localhost:3000/files/5/share>' \\
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJleHAiOjE2ODAwMDkwNDZ9.K8jBFmAruSMW4MGWCmQJ5MIwxaQ-O9E0Aehsi4GOpPc'

Response

Success

• HTTP Status: 200 OK
• Content-Type: application/json

{
    "share_link": "<https://d237198xeojlsg.cloudfront.net/share/RNrKNzPNmbasJQn38RwxuF_XDQw>"
}

Error

• HTTP Status: 404 Not Found
• Content-Type: application/json

{
    "error": "File not found."
}

Error

• HTTP Status: 400