For AI agents: a machine-readable documentation index for this API is available at /llms.txt. Every page is also available as Markdown: append ".md" to the URL or send an "Accept: text/markdown" request header.

Start an upload into a folder (body: name, size, folder_id, content_type, sha256, on_conflict); returns signed URLs, or creates an empty file directly when size is 0

Starts an upload of size bytes into folder_id (the library root by default). A small file gets one signed URL; a larger file gets mode multipart, a part_size and the first 20 signed part URLs (signUploadParts returns more). PUT the bytes to each URL, then call completeUpload. A file of size 0 is created at once (action created). When the name already exists in the folder and the app's duplicate rule would ask, the call is 409 conflict and details.choices lists your answers: send one as on_conflict (version adds a new version of the existing file, separate keeps both under a numbered name, skip uploads nothing). In other cases the same rule as the app applies: depending on the plan the existing file gets a new version or the new file gets a numbered name, and an identical file is skipped (action skip, status 200). A version upload answers with kind version and the existing file_id; the rest of the flow is the same. Needs files:write.

What you provide

  • Name: The file name, at most 255 bytes
  • Size: The file's size in bytes. 0 creates an empty file at once
  • Folder idoptional: The folder to upload into. Omit or null for the library root
  • Content typeoptional: The media type, without control characters. Default application/octet-stream
  • Sha256optional: The SHA-256 of the file's bytes as 64 hexadecimal characters
  • On conflictoptional: Your answer when the app's duplicate rule would ask: version, separate or skip. See startUpload
  • Modified atoptional: The file's own modification time: ISO 8601 with a time zone, after 1970-01-02 and at most one day ahead

Do this with AI

I want to start an upload into a folder (body: name, size, folder_id, content_type, sha256, on_conflict); returns signed URLs, or creates an empty file directly when size is 0. Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/startupload.md Authenticate with your API key as a Bearer token in the Authorization header. Then make the request for me and tell me what came back.

Paste this into Claude, Cursor, or any AI assistant and it will do it for you.