Skip to main content
GET
/
storage
/
signed-url
curl -X GET "https://api.nonefivem.com/cloud/storage/signed-url" \
  -H "Authorization: Bearer your-api-key"

{
  "url": "https://storage.nocloud.dev/upload/signed/abc123...",
  "expiresAt": "2026-02-06T13:00:00Z"
}
Generate a pre-signed URL that allows direct file uploads to NoCloud storage. This is useful for client-side uploads where you don’t want to proxy files through your server.

​
Authorization

​
Authorization
string
required
Bearer token for authentication. Format: Bearer <your-api-key>

​
Required Permission

STORAGE_WRITE

​
Query Parameters

Query parameters are optional. Provide them only if you want to pre-allocate storage for the file. If omitted, a non-allocated signed URL is generated instead.
​
contentType
string
MIME type of the file to upload
​
size
number
Size of the file in bytes
​
metadata
record<string, string | number | boolean>
Optional metadata to attach to the file

​
Response

​
Without query parameters (non-allocated)

​
url
string
The pre-signed URL for uploading. Upload to this URL using a POST request with the file as form data. You can optionally include a metadata field in the form data.
​
expiresAt
string
ISO 8601 timestamp when the URL expires

​
With query parameters (pre-allocated)

When query parameters are provided, the response includes additional fields for the pre-allocated media:
​
url
string
The pre-signed URL for uploading. Upload to this URL using a PUT request.
​
expiresAt
string
ISO 8601 timestamp when the URL expires
​
mediaId
string
The ID the file will have after upload
​
mediaUrl
string
The public CDN URL where the file will be accessible after upload
curl -X GET "https://api.nonefivem.com/cloud/storage/signed-url" \
  -H "Authorization: Bearer your-api-key"

{
  "url": "https://storage.nocloud.dev/upload/signed/abc123...",
  "expiresAt": "2026-02-06T13:00:00Z"
}
Signed URLs expire after 15 minutes. Generate a new URL if the upload doesn’t complete in time.

Uploading Files Guide

Learn how to upload files using signed URLs with complete examples in multiple languages.