Skip to main content
Presigned URLs allow you to grant temporary permission to upload a file directly to Fivemanage without sharing your API key with the client.

​
Server-Side Export

​
requestPresignedUrl

Requests a presigned URL from the Fivemanage API. Definition: 
requestPresignedUrl(fileType: "image" | "audio" | "video"): Promise<string>
Usage: 
local presignedUrl = exports.fmsdk:requestPresignedUrl("image")

if presignedUrl then
    print("Generated presigned URL: " .. presignedUrl)
    -- You can now send this URL to a client to perform a direct upload
end

​
How it works

  1. Server Request: Your server script calls requestPresignedUrl.
  2. API Response: Fivemanage returns a unique, time-limited URL.
  3. Client Upload: Your server sends this URL to the client (e.g., via a NUI callback or client event).
  4. Direct Upload: The client performs an HTTP PUT or POST request to that URL with the file data.
This approach is more efficient for large files (like videos or high-quality audio) as the data doesn’t need to pass through your FiveM server.

​
Example: Client-side Upload (Conceptual)

Server: 
RegisterNetEvent('myResource:getUploadUrl', function()
    local src = source
    local url = exports.fmsdk:requestPresignedUrl("image")
    TriggerClientEvent('myResource:receiveUploadUrl', src, url)
end)
Client (NUI/JS): 
// After receiving the URL from the server
async function uploadFile(url, fileBlob) {
    const response = await fetch(url, {
        method: 'PUT',
        body: fileBlob,
        headers: {
            'Content-Type': 'image/png'
        }
    });
    
    if (response.ok) {
        console.log("Upload successful!");
    }
}