API Reference

Returns the build version of the running server.

{
  "version": "1.4.0"
}

copycurl -s $BASE/api/v0/version

Generates a fresh AES key. The key is returned once and never persisted.

{
  "key": "b64-encoded-aes-key"
}

copycurl -s $BASE/api/v0/cipher/aes

Encrypts data with the given AES key.

{
  "data": "b64-cipher-text"
}

copycurl -s -X POST $BASE/api/v0/cipher/aes/encrypt \
  -H 'Content-Type: application/json' \
  -d '{"data":"hello","key":"<key>"}'

Decrypts data produced by the encrypt endpoint using the same key.

{
  "data": "hello"
}

copycurl -s -X POST $BASE/api/v0/cipher/aes/decrypt \
  -H 'Content-Type: application/json' \
  -d '{"data":"<cipher>","key":"<key>"}'

Creates a short url pointing at url.

{
  "id": "aB3xY",
  "token": "8f14e45f-…"
}

copycurl -s -X POST $BASE/api/v0/short-url \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com"}'

Resolves a short url and redirects to the target. This is the link you share.

copycurl -sI $BASE/api/v0/short-url/aB3xY

Deletes a short url. The token may be passed as a query param or in the JSON body.

copycurl -s -X DELETE "$BASE/api/v0/short-url/aB3xY?token=<token>"

Creates a new link repository. Note the trailing slash — it is part of the route.

{
  "repositoryId": "3f1c…-uuid",
  "token": "1a2b…-uuid",
  "name": "my links",
  "createdAt": "2026-07-22T10:15:30Z"
}

copycurl -s -X POST $BASE/api/v0/repository/links/ \
  -H 'Content-Type: application/json' \
  -d '{"name":"my links"}'

Returns the repository with all of its links. The token is never echoed back.

{
  "repositoryId": "3f1c…-uuid",
  "name": "my links",
  "createdAt": "2026-07-22T10:15:30Z",
  "links": [
    {
      "uuid": "9d0e…-uuid",
      "url": "https://example.com",
      "name": "example",
      "description": ""
    }
  ]
}

copycurl -s "$BASE/api/v0/repository/links/<id>?token=<token>"

Deletes a repository together with all links inside it.

copycurl -s -X DELETE "$BASE/api/v0/repository/links/<id>?token=<token>"

Adds a link to the repository.

{
  "uuid": "9d0e…-uuid",
  "url": "https://example.com",
  "name": "example",
  "description": ""
}

copycurl -s -X POST "$BASE/api/v0/repository/links/<id>/links?token=<token>" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","name":"example"}'

Replaces the stored link with the values from the body.

copycurl -s -X PUT "$BASE/api/v0/repository/links/<id>/links/<uuid>?token=<token>" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.org"}'

Removes a single link from the repository.

copycurl -s -X DELETE "$BASE/api/v0/repository/links/<id>/links/<uuid>?token=<token>"

Uploads a single file as multipart/form-data.

{
  "uuid": "7c2d…-uuid",
  "token": "4e5f…-uuid",
  "name": "report.pdf",
  "expiredTime": 1785000000000
}

copycurl -s -X POST $BASE/api/v0/uploaded-files \
  -F '[email protected]' \
  -F 'name=report.pdf' \
  -F 'ttl=3600'

Returns the configured upload limit, so clients can reject oversized files before sending them.

{
  "megabytes": 100,
  "bytes": 104857600
}

copycurl -s $BASE/api/v0/uploaded-files/max-size

Metadata of one file. The token is never included in the response.

{
  "uuid": "7c2d…-uuid",
  "name": "report.pdf",
  "expiredTime": 1785000000000
}

copycurl -s "$BASE/api/v0/uploaded-files/<uuid>?token=<token>"

Streams the file content as application/octet-stream with a Content-Disposition attachment header.

copycurl -sOJ "$BASE/api/v0/uploaded-files/<uuid>/download?token=<token>"

Deletes the file and its metadata. The token may be a query param or a JSON body field.

copycurl -s -X DELETE "$BASE/api/v0/uploaded-files/<uuid>?token=<token>"

Listing every uploaded file is deliberately not allowed — the route exists but always refuses. Files are reachable only by uuid plus token.

{
  "error": "Listing all files is not allowed"
}

Returns the raw yt-dlp metadata JSON for a video.

copycurl -s "$BASE/api/v0/youtube/info?url=https://youtu.be/<id>"

Downloads the video on the server and returns the MP4 bytes (video/mp4).

copycurl -s -o video.mp4 "$BASE/api/v0/youtube/download?url=https://youtu.be/<id>"

Returns the caller's ip as the server sees it. Behind a proxy the value comes from CF-Connecting-IP, then X-Forwarded-For, then the socket address — good enough to show users their own ip, not for auth or rate limiting.

{
  "ip": "203.0.113.7"
}

copycurl -s $BASE/api/v0/network/ip

The index page listing every service.

The site favicon (ss_icon.svg).

Lists the files available in a category.

copycurl -s $BASE/static/v0/json

Returns one static file with the content type of its category.

copycurl -s $BASE/static/v0/html/api_docs.html