Tool reference

Every tool name carries the nucifra_ prefix. Every result carries a JSON block alongside its text summary.

nucifra_create_upload_url

Mints a presigned upload link for one file. The file goes straight to storage. It never passes through Nucifra’s servers.

Input: filename, content_type, size_bytes

Output: key, upload_url, method (always PUT), required_headers, expires_at

The link expires in 15 minutes. Use it once.

nucifra_create_public_url

Confirms the file arrived, corrects its stored size if needed, and mints a public link.

Input: key, expires_in_seconds (optional)

Output: url, content_type, size_bytes, expires_at

The default link lasts one hour. The longest link lasts 7 days.

nucifra_list_objects

Lists the files already sent, newest first.

Input: prefix (optional), limit (default 25, maximum 100), cursor (optional)

Output: objects (key, size_bytes, content_type, uploaded_at for each), cursor (present when more files remain)

nucifra_delete_object

Removes one file. This cannot be undone.

Input: key

Output: deleted (always true on success), key

Errors

Every failure names the limit, the number, and a fix. A terminal error, such as a suspended account, says “Do not retry.” A quota error, such as a full plan, links to the upgrade page.