Upload Media

Upload a new media file. Use OAuth Bearer auth, API key auth from Authorize (x-medialit-apikey), or pass x-medialit-signature for this endpoint only.

POST

/media/create

Serverhttps://api.medialit.cloud

Authentication

Header parameters

Body

Authentication

Bearer token (JWT)
Or API key in the x-medialit-apikey header
Or API key in the x-medialit-signature header

Parameters

header parameters

Name	Type	Description
`x-medialit-signature`	`string`	Upload Signature for secure client-side uploads

Request body

multipart/form-data

required

filestring (binary)
required
captionstring
accessstringOne of: "public", "private"
groupstring

Responses

200

The created Media object

mediaIdstring
required
originalFileNamestring
required
mimeTypestring
required
sizenumber (float)
required
accessstring
required
One of: "public", "private"
filestring
required
thumbnailstring
captionstring
groupstring

400

Bad Request

errorstring
required

401

Unauthorized

errorstring
required

404

Invalid signature

errorstring
required

500

Internal Server Error

errorstring
required

Request

curl -X POST 'https://api.medialit.cloud/media/create' \
  -H 'Authorization: Bearer $API_TOKEN' \
  -F 'file=@file'

const form = new FormData();
form.append("file", file);

const response = await fetch("https://api.medialit.cloud/media/create", {
  method: "POST",
  headers: {
    "Authorization": "Bearer $API_TOKEN",
  },
  body: form,
});
const data = await response.json();

import requests

response = requests.request(
    "POST",
    "https://api.medialit.cloud/media/create",
    headers={
        "Authorization": "Bearer $API_TOKEN",
    },
    files={"file": open("file", "rb")},
)
data = response.json()

package main

import (
	"bytes"
	"fmt"
	"io"
	"mime/multipart"
	"net/http"
	"os"
)

func main() {
	var body bytes.Buffer
	form := multipart.NewWriter(&body)
	file, _ := os.Open("file")
	defer file.Close()
	part, _ := form.CreateFormFile("file", "file")
	io.Copy(part, file)
	form.Close()
	req, _ := http.NewRequest("POST", "https://api.medialit.cloud/media/create", &body)
	req.Header.Set("Authorization", "Bearer $API_TOKEN")
	req.Header.Set("Content-Type", form.FormDataContentType())
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

// multipart/form-data: build the body with a library such as OkHttp,
// with the fields file.
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.medialit.cloud/media/create"))
    .header("Authorization", "Bearer $API_TOKEN")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.medialit.cloud/media/create");
request.Headers.Add("Authorization", "Bearer $API_TOKEN");
var form = new MultipartFormDataContent();
form.Add(new StreamContent(File.OpenRead("file")), "file", "file");
request.Content = form;
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

{
  "mediaId": "string",
  "originalFileName": "string",
  "mimeType": "string",
  "size": 0,
  "access": "public",
  "file": "string",
  "thumbnail": "string",
  "caption": "string",
  "group": "string"
}

{
  "error": "Bad Request"
}

{
  "error": "Unauthorized"
}

{
  "error": "Invalid signature"
}

{
  "error": "Internal Server Error"
}