OkFile Skill

Official site: https://www.okfile.com/

Overview

OkFile is an agent-first file upload and publish skill.

Use it when an agent needs to:

• upload images, videos, PDFs, or common files
• upload a static site folder and publish it to a per-site subdomain
• rely on automatic shared top-level directory stripping for folder-based site uploads
• expose a directory listing when a site has no root index.html
• return a direct link via url
• return a preview or playback link via playUrl
• return a published site URL via siteUrl or entryUrl
• publish anonymously or with an API key
• handle multipart uploads and retry only missing parts

When To Trigger

Trigger this skill when the user asks to:

• upload a file
• publish a file and return a public link
• generate a preview URL for an image, video, or PDF
• publish a folder as a static website
• publish a folder that may not contain root index.html
• upload a large file with multipart support
• retry incomplete multipart uploads

Minimal Flow

1. POST /api/upload/prepare
2. PUT uploadUrl or each parts[].uploadUrl
3. POST /api/upload/complete
4. optionally GET /api/upload/status/{id}

Static Site Flow

5. POST /api/site/prepare
6. upload each file through the normal file upload flow
7. POST /api/site/complete

Static site behavior:

• if every uploaded path is under one shared top-level folder, OkFile strips that folder and treats its contents as the site root
• if root index.html exists, the site root renders that page
• if root index.html does not exist, the site root renders a directory listing with file name, size, and upload time
• images and videos open inline from that listing
• other files should use download links

Minimal Example

curl -X POST "https://www.okfile.com/api/upload/prepare" \
  -H "Content-Type: application/json" \
  --data '{"filename":"photo.jpg","size":12345,"contentType":"image/jpeg","preferredPartSize":5242880}'
curl -X POST "https://www.okfile.com/api/upload/complete" \
  -H "Content-Type: application/json" \
  --data '{"id":"a3k7m92x"}'

Core Rules

• send apiKey only to prepare
• send only id to complete
• if complete returns missingParts, re-upload only those parts
• prefer url for direct consumption
• include playUrl when preview matters
• prefer siteUrl for the root of a published static site
• prefer entryUrl for the preferred HTML entry page

Endpoints

• POST /api/upload/prepare
• PUT uploadUrl or parts[].uploadUrl
• POST /api/upload/complete
• GET /api/upload/status/{id}
• GET /i/{id}
• GET /i/{id}?play=1
• POST /api/site/prepare
• POST /api/site/complete

Limits

• max file size: 500MB
• multipart starts automatically above the backend threshold
• anonymous mode is IP rate-limited
• API key mode is controlled by backend quotas

Useful URLs

• home: https://www.okfile.com/en/
• upload page: https://www.okfile.com/en/upload/
• account: https://www.okfile.com/account
• admin: https://www.okfile.com/admin