/api/qmail/net/messages/upload

// Step 1 — stage the upload (returns task_id + file_guid)
const upload = await fetch('http://localhost:8081/api/qmail/net/messages/upload?body=QMail%20upload-only%20doc%20test%20from%20Client1%20%28no%20Tell%20will%20fire%29.&subject=Upload-only%20Doc%20Test&to=%40chariot.harbor.byte&duration=4').then(r => r.json());
if (!upload.success) {
    throw new Error(`Upload kickoff failed: ${upload.message}`);
}
console.log(`Upload task=${upload.task_id} guid=${upload.file_guid}`);

// Step 2 — poll the task until status leaves "running"
async function pollTask(taskId) {
    while (true) {
        const r = await fetch(`/api/system/tasks?id=${encodeURIComponent(taskId)}`);
        const t = await r.json();
        if (t.status !== 'running') return t;
        await new Promise(r => setTimeout(r, 1000));
    }
}
const finalState = await pollTask(upload.task_id);
console.log('Upload result:', finalState);

// Step 3 (optional) — fire Tell to deliver
//   const fireTellUrl = `/api/qmail/net/messages/tell?file_guid=${upload.file_guid}`;
//   const tell = await fetch(fireTellUrl).then(r => r.json());

import time
import requests

BASE = 'http://localhost:8081/api'

# Step 1 — stage the upload (returns task_id + file_guid)
upload = requests.get(f'{BASE}/qmail/net/messages/upload', params={
    'body':    'QMail upload-only doc test from Client1.',
    'subject': 'Upload Doc Test',
    'to':      '@chariot.harbor.byte',
    'duration': 4,
}).json()
assert upload['success'], upload
task_id   = upload['task_id']
file_guid = upload['file_guid']
print(f'task={task_id} guid={file_guid}')

# Step 2 — poll the task until status leaves "running"
while True:
    t = requests.get(f'{BASE}/system/tasks', params={'id': task_id}).json()
    if t['status'] != 'running':
        break
    time.sleep(1)
print('Upload result:', t)

# Step 3 (optional) — fire Tell to deliver
# tell = requests.get(f'{BASE}/qmail/net/messages/tell', params={'file_guid': file_guid}).json()