Project Workflow Integration

curl -X POST 'https://synapfoundry.ai/api/v1/projects/{PROJECT_ID}/documents/upload' \
  -H 'Authorization: Bearer {API_KEY}' \
  -F 'file=@{FILE_PATH}'

import requests

api_key = "{API_KEY}"
file_path = "/path/to/your/file.ext"
url = "https://synapfoundry.ai/api/v1/projects/{PROJECT_ID}/documents/upload"

headers = { "Authorization": f"Bearer {api_key}" }

with open(file_path, "rb") as file:
    files = { "file": file }
    response = requests.post(url, headers=headers, files=files)

document_uuid = response.json()["documentUuid"]

const axios = require('axios');
const fs = require('fs');
const FormData = require('form-data');

const apiKey = "{API_KEY}";
const projectId = "{PROJECT_ID}";
const filePath = "/path/to/your/file.ext";
const url = `https://synapfoundry.ai/api/v1/projects/${projectId}/documents/upload`;

const form = new FormData();
form.append('file', fs.createReadStream(filePath));

const headers = {
  ...form.getHeaders(),
  'Authorization': `Bearer ${apiKey}`,
};

axios.post(url, form, { headers }).then(response => {
  const documentUuid = response.data.documentUuid;
  console.log(documentUuid);
}).catch(error => {
  console.error('Error:', error.response?.data || error.message);
});

{
  "documentId": 1289,
  "documentUuid": "550e8400-e29b-41d4-a716-446655440000"
}

curl -X GET 'https://synapfoundry.ai/api/v1/external/documents/{DOC_UUID}/status' \
  -H 'Authorization: Bearer {API_KEY}'

import requests
import time

api_key = "{API_KEY}"
url = "https://synapfoundry.ai/api/v1/external/documents/{DOC_UUID}/status"
headers = { "Authorization": f"Bearer {api_key}" }

interval = 5
max_seconds = 1800  # 30-minute safety cap
elapsed = 0

while elapsed < max_seconds:
    response = requests.get(url, headers=headers)
    if response.status_code >= 500:
        # 5xx: retry after backoff
        time.sleep(interval)
        elapsed += interval
        interval = min(interval * 2, 60)
        continue
    response.raise_for_status()  # 4xx: raise immediately and stop polling
    status = response.json()["status"]
    if status in ("succeeded", "failed"):
        break
    time.sleep(interval)
    elapsed += interval
    interval = min(interval * 2, 60)
else:
    raise TimeoutError("Polling exceeded 30 minutes.")

const axios = require('axios');

const apiKey = "{API_KEY}";
const docUuid = "{DOC_UUID}";
const url = `https://synapfoundry.ai/api/v1/external/documents/${docUuid}/status`;

async function pollStatus() {
  let interval = 5000;
  const maxMs = 30 * 60 * 1000; // 30-minute safety cap
  let elapsed = 0;

  while (elapsed < maxMs) {
    try {
      const { data } = await axios.get(url, {
        headers: { 'Authorization': `Bearer ${apiKey}` }
      });
      if (data.status === 'succeeded' || data.status === 'failed') {
        return data.status;
      }
    } catch (err) {
      const code = err.response?.status;
      if (code && code >= 400 && code < 500) {
        // 4xx: do not retry — stop polling
        throw err;
      }
      // 5xx / network errors: retry after backoff
    }
    await new Promise(r => setTimeout(r, interval));
    elapsed += interval;
    interval = Math.min(interval * 2, 60000);
  }
  throw new Error('Polling exceeded 30 minutes.');
}

{ "status": "processing" }

curl -L 'https://synapfoundry.ai/api/v1/external/documents/{DOC_UUID}/export' \
  -H 'Authorization: Bearer {API_KEY}' \
  -o result.zip

import requests

api_key = "{API_KEY}"
url = "https://synapfoundry.ai/api/v1/external/documents/{DOC_UUID}/export"

response = requests.get(url, headers={ "Authorization": f"Bearer {api_key}" })

with open("result.zip", "wb") as f:
    f.write(response.content)

const axios = require('axios');
const fs = require('fs');

const apiKey = "{API_KEY}";
const docUuid = "{DOC_UUID}";
const url = `https://synapfoundry.ai/api/v1/external/documents/${docUuid}/export`;

axios.get(url, {
  headers: { 'Authorization': `Bearer ${apiKey}` },
  responseType: 'stream'
}).then(response => {
  response.data.pipe(fs.createWriteStream('result.zip'));
}).catch(error => {
  console.error('Error:', error.response?.data || error.message);
});