Skip to main content

Upload & Validate Data Guide

Upload and validate data files before use in river generation.

Upload a File​

const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("category", "terrain");
formData.append("description", "Mountain terrain data");

const response = await fetch("https://api.rivegen.com/api/files/upload", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${TOKEN}`
  },
  body: formData
});

const { file_id, filename, size } = await response.json();

Validate Data​

const validateFormData = new FormData();
validateFormData.append("file", fileInput.files[0]);
validateFormData.append("validation_type", "terrain");

const response = await fetch("https://api.rivegen.com/api/data/validate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${TOKEN}`
  },
  body: validateFormData
});

const validation = await response.json();

if (validation.valid) {
  console.log("File is valid!");
} else {
  console.error("Validation errors:", validation.errors);
}

Use Validated Data​

Once validated, use the file in river generation:

await fetch("https://api.rivegen.com/api/rivers/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${TOKEN}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    project_id: "project_123",
    parameters: {
      terrain_data_file_id: file_id,
      // ... other parameters
    }
  })
});

See Also​