Init File Storage

POSThttps://api.repliz.com/public/storage/file/init

Initialize a file upload session. Provide the filename, file size, and MIME type to create an upload session. The response includes an upload URL where the file should be uploaded directly using a PUT request.

Endpoint Details

• Authentication: Basic Auth (Authorization: Basic Base64(AccessKey:SecretKey))
• Access Tier: Addon Storage

Request Body

Field	Type	Required	Description
filename	string	Yes	Name of the file, with its extension, for example repliz-demo.mp4. It becomes the last part of the file URL and is what Get File searches.
size	number	Yes	Size of the file in bytes. It has to fit in the free space from Get Statistic, or the call returns 402. The real size is read again by Complete File.
mimetype	string	Yes	MIME type of the file, for example video/mp4 or image/png. Send the same value as the Content-Type header of the upload.

Example Request

cURL

curl -X POST "https://api.repliz.com/public/storage/file/init" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "video.mp4",
    "size": 102400,
    "mimetype": "video/mp4"
  }'

Axios

import axios from 'axios';

const response = await axios.post(
  'https://api.repliz.com/public/storage/file/init',
  {
    filename: 'video.mp4',
    size: 102400,
    mimetype: 'video/mp4',
  },
  {
    auth: {
      username: 'YOUR_ACCESS_KEY',
      password: 'YOUR_SECRET_KEY',
    },
  },
);

console.log(response.data);

Fetch

const credentials = btoa('YOUR_ACCESS_KEY:YOUR_SECRET_KEY');

const response = await fetch('https://api.repliz.com/public/storage/file/init', {
  method: 'POST',
  headers: {
    Authorization: `Basic ${credentials}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    filename: 'video.mp4',
    size: 102400,
    mimetype: 'video/mp4',
  }),
});

const data = await response.json();
console.log(data);

Response

200

{
  "id": "6a4c3a3bc4586b1f1ce483e4",
  "upload": "https://repliz.2ca853e78c4cd1a89797e3d770c7ca9f.r2.cloudflarestorage.com/uploads/6879b98097fc8c8a78d1d4c1/0dcb2544-bbc8-4b42-a2e3-0449133ef58f.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&...",
  "key": "uploads/6879b98097fc8c8a78d1d4c1/0dcb2544-bbc8-4b42-a2e3-0449133ef58f.mp4",
  "url": "https://storage.repliz.com/uploads/6879b98097fc8c8a78d1d4c1/0dcb2544-bbc8-4b42-a2e3-0449133ef58f.mp4"
}

402

{
  "code": 429,
  "message": "upgrade to get more storage"
}

401

{
  "code": 401,
  "message": "unauthorized"
}