Uploads a file to sxcu.net
Allowed file types: png, jpg/jpeg, tif/tiff, gif, Icons (.ico), Bitmap images, Web videos (webm).

Resource URL

POST /upload


Parameter Description Optional Default
image Binary file. The image you want to upload, up to 95 MB in size. No None
token String. The upload token for the sub domain that's being used, if one required. Yes None
collection String. The collection ID to which you want to upload to if you want to upload to a collection. Yes None
collection_token String. the collection upload token if one is required by the collection you're uploading to. Yes None
noembed Void. If present, the uploader will return a direct URL to the uploaded image, instead of a dedicated page. Yes None
og_properties JSONArray. If present, this JSON array will configure the OpenGraph properties of the file's page, effectively changing the way it embeds in various websites and apps.

JSON array parameters:
color - sets the theme-color tag, useful to change the embed color in a Discord embed.
description - changes the og:description tag.
title - changes the og:title tag.
discord_hide_url - if true, discord will hide the file's URL and display only the image in chat, if false, the file's URL will also be shown.

    "title":"Some title",
    "description":"A cool description!",
    "discord_hide_url": false
And this is how it looks in Discord.
Yes None


POST https://sxcu.net/upload





Response JSON Params

Parameter Type Description
url String The URL to the uploaded image
del_url String The deletion URL for this image, opening this link will delete the image with no confirmation!
thumb String The thumbnail URL to this image (will only be present if file is PNG, JPEG or GIF).

Response error codes and messages

Status code Message Description
412 User-agent header not set The request did not contain a User-Agent header.
410 Collection is private but no collection token provided The collection you tried to upload to is set to private and requires a collection token in order to upload to it.
407 Subdomain is private, a valid upload token is required The sub domain you tried to upload to is private, and requires a valid upload token in order to upload to it.
403 Invalid upload token The specified upload token does not match the domain's upload token.
416 Invalid collection token The specified collection token does not match the collection's token.
404 Collection not found The specified collection was not found.
405 Request is not POST The request method must be POST.
406 Upload error 101x An error occurred while handling the uploaded file.
409 No file sent No binary file was sent in the 'image' field.
413 File is over the size limit Uploaded file is larger than 95 MB.
415 File type not allowed. The type of the uploaded file is not supported.
422 Malformed JSON in OpenGraph properties The OpenGraph properties JSON array could not be properly parsed, and is most likely malformed.
429 (none) The request exceeded the rate limit.
500 The file was not uploaded due to an unknown error An unknown error has occurred while processing the file, try again later.

Resource Information

Rate Limit 1 request per minute
Response Format JSON
Authentication None