Skip to main content
GET
/
storage
/
signed-url
curl -X GET "https://api.nonefivem.com/cloud/storage/signed-url?contentType=image/png&size=1048576" \
  -H "Authorization: Bearer your-api-key"
{
  "url": "https://storage.nocloud.dev/upload/signed/abc123...",
  "expiresAt": "2026-02-06T13:00:00Z",
  "mediaId": "550e8400-e29b-41d4-a716-446655440000",
  "mediaUrl": "https://cdn.nonefivem.com/c/{ORGANIZATION_ID}/550e8400-e29b-41d4-a716-446655440000"
}
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

contentType
string
required
MIME type of the file to upload
size
number
required
Size of the file in bytes
metadata
record<string, string | number | boolean>
Optional metadata to attach to the file

Response

url
string
The pre-signed URL for uploading
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?contentType=image/png&size=1048576" \
  -H "Authorization: Bearer your-api-key"
{
  "url": "https://storage.nocloud.dev/upload/signed/abc123...",
  "expiresAt": "2026-02-06T13:00:00Z",
  "mediaId": "550e8400-e29b-41d4-a716-446655440000",
  "mediaUrl": "https://cdn.nonefivem.com/c/{ORGANIZATION_ID}/550e8400-e29b-41d4-a716-446655440000"
}
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.