S.EE Docs
API Reference

Create Large File Upload Session

Creates a TUS upload session for files up to 5 GB. Returns an upload_id and TUS endpoint URL. If a file_hash is provided and the file already exists, an instant upload result is returned without needing to transfer any data.

POST
/api/v1/file/large-file/create

Header Parameters

Authorization*string

API key

Request Body

Upload session parameters

application/json
  1. body
alias?string

Custom slug for the short link (optional, alphanumeric only)

Lengthlength <= 255
description?string

Description (optional)

Lengthlength <= 1024
domain?string

Domain for short link (optional, use /api/v1/file/domains to list)

Lengthlength <= 255
expire_at?integer

Unix timestamp for link expiry (optional)

file_hash?string

SHA256 hash for instant upload deduplication (optional)

Lengthlength <= 255
file_name*string

Original filename (required)

Lengthlength <= 255
file_size*integer

File size in bytes (required)

is_private?integer

Privacy: 0=public (default), 1=private

Value in01
mime_type?string

MIME type hint (optional, server will detect from file bytes)

Lengthlength <= 255
password?string

Access password (3–32 chars, optional)

Length3 <= length <= 32
replace_file_id?integer

ID of an existing file whose content should be replaced by this upload (optional). The short link and the file URL stay unchanged; title, domain, alias, password and is_private are ignored.

title?string

Title for the file (optional)

Lengthlength <= 255

Response Body

OK

application/json
  1. response
code?integer
data?
message?string
Example Request
curl -X POST 'https://s.ee/api/v1/file/large-file/create' \  -H 'Authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "file_name": "string",  "file_size": 0}'
Example Response200
{  "code": 0,  "data": {    "existing_file": {      "created_at": 0,      "delete": "string",      "file_id": 0,      "filename": "string",      "hash": "string",      "height": 0,      "mime_type": "string",      "page": "string",      "path": "string",      "size": 0,      "storename": "string",      "thumb_url": "string",      "upload_status": 0,      "url": "string",      "width": 0    },    "expires_at": 0,    "fast_upload": true,    "file_size": 0,    "id": 0,    "upload_id": "string",    "upload_url": "string"  },  "message": "string"}

Get Available Domains for File Sharing GET

Returns a list of all domains available for creating file sharing URLs with your account. Use these domain values when calling the File Upload endpoint.

TUS Upload Chunk PATCH

Uploads a chunk of a large file using the TUS 1.0 protocol. Use a TUS client library rather than calling this directly. The upload_id comes from the Create Large File Upload Session endpoint.