API Documentation

This API endpoint allows you to renew the shared link for a file or folder. When you renew a link, a new file entry is created with a new ID (and thus a new share link), while preserving all file data including downloads, views, and other metadata. The old link will no longer work after renewal.

Note: The file must be public (not private) and you must be the owner of the file to renew its link.

This endpoint requires authentication using Bearer token in the Authorization header.

Get your API token at API Settings Page

• cURL
• Python
• PHP
• Node.js

curl -X POST "https://akirabox.com/api/files/{id}/renew-link" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json"

import requests

url = "https://akirabox.com/api/files/{id}/renew-link"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json={})
print(response.json())

$url = 'https://akirabox.com/api/files/{id}/renew-link';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Accept: application/json',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

const axios = require('axios');

const renewLink = async () => {
    try {
        const response = await axios.post(
            'https://akirabox.com/api/files/{id}/renew-link',
            {},
            {
                headers: {
                    'Authorization': 'Bearer YOUR_API_TOKEN',
                    'Accept': 'application/json',
                    'Content-Type': 'application/json'
                }
            }
        );
        
        console.log(response.data);
    } catch (error) {
        if (error.response) {
            console.error('Error:', error.response.data.message);
        } else {
            console.error('Error:', error.message);
        }
    }
};

renewLink();

Successful Response (200)

{
    "success": true,
    "message": "Link renewed successfully",
    "data": {
        "id": "new_hashed_id",
        "name": "example.pdf",
        "type": "file",
        "shared_link": "https://akirabox.com/new_hashed_id/file",
        "downloads": 10,
        "view_number": 25
    }
}

Error Response (404)

{
    "success": false,
    "message": "File or folder not found"
}

Error Response (403)

{
    "success": false,
    "message": "You do not have permission to renew this link"
}

Error Response (400)

{
    "success": false,
    "message": "Private files or folders cannot be shared, change the visibility to public before sharing."
}

Success Response Object

Data Object

• The file or folder must be public (not private) to renew the link
• You must be the owner of the file/folder to renew its link
• The old link will stop working immediately after renewal
• All file data (downloads, views, metadata) is preserved in the new link
• For folders, all children are automatically updated to point to the new folder