async function fetchPaginated(endpoint, { skip = 0, limit = 20, sortField, sortOrder, searchTerm } = {}) {
  const params = new URLSearchParams({ skip, limit });
  if (sortField) params.set("sortField", sortField);
  if (sortOrder) params.set("sortOrder", sortOrder);
  if (searchTerm) params.set("searchTerm", searchTerm);

  const response = await fetch(
    `https://api.neostra.io/v1/${endpoint}?${params}`,
    { headers: { Authorization: `Bearer ${token}` } }
  );

  const { data } = await response.json();
  return data; // { totalCount, skip, limit, results }
}

// Usage
const page1 = await fetchPaginated("assessments", { limit: 10 });
const page2 = await fetchPaginated("assessments", { skip: 10, limit: 10 });

import requests

def fetch_paginated(endpoint, skip=0, limit=20, sort_field=None, sort_order=None, search=None):
    params = {"skip": skip, "limit": limit}
    if sort_field:
        params["sortField"] = sort_field
    if sort_order:
        params["sortOrder"] = sort_order
    if search:
        params["searchTerm"] = search

    response = requests.get(
        f"https://api.neostra.io/v1/{endpoint}",
        headers={"Authorization": f"Bearer {token}"},
        params=params,
    )
    return response.json()["data"]

# Usage
page = fetch_paginated("assessments", skip=0, limit=10, search="privacy")
print(f"Total: {page['totalCount']}, Returned: {len(page['results'])}")

import requests

def api_request(method, endpoint, body=None):
    response = requests.request(
        method,
        f"https://api.neostra.io/v1/{endpoint}",
        headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
        json=body,
    )

    result = response.json()

    if not response.ok:
        if response.status_code == 400:
            errors = result.get("data", {}).get("errors", [])
            for error in errors:
                print(f"  {error['field']}: {error['message']}")
        elif response.status_code == 401:
            print("Token expired. Please re-authenticate.")
        elif response.status_code == 403:
            print(f"Access denied: {result['message']}")

        raise Exception(result["message"])

    return result["data"]

const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("context", "assessment");
formData.append("referenceId", "assessment-abc-123");

const response = await fetch("https://api.neostra.io/v1/storage/file-upload", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    // Do not set Content-Type — the browser sets it with the boundary
  },
  body: formData,
});

const { data } = await response.json();
// data contains: { fileId, fileName, fileUrl, mimeType, size }

import requests

with open("/path/to/document.pdf", "rb") as f:
    response = requests.post(
        "https://api.neostra.io/v1/storage/file-upload",
        headers={"Authorization": f"Bearer {token}"},
        files={"file": ("document.pdf", f, "application/pdf")},
        data={"context": "assessment", "referenceId": "assessment-abc-123"},
    )

result = response.json()["data"]
print(f"Uploaded: {result['fileName']} ({result['size']} bytes)")

const response = await fetch("https://api.neostra.io/v1/assessments", {
  headers: { Authorization: `Bearer ${token}` },
});

const correlationId = response.headers.get("X-Correlation-Id");
console.log(`Request traced as: ${correlationId}`);