Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.datris.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Configuration API lets you upload validation schemas and generate JSON Schema or XSD from sample data using AI.

​
Upload Config File

Upload a validation schema to the platform’s configuration store (MinIO). 
POST /api/v1/config/upload
Content-Type: multipart/form-data
ParameterTypeRequiredDescription
fileform-dataYesThe configuration file to upload
typeform-dataYesFile type: validation-schema
The uploaded file is stored at {env}-config/{type}/{filename} in MinIO and can be referenced in pipeline configurations.

​
Example

curl -X POST http://localhost:8080/api/v1/config/upload \
  -F "file=@my-schema.json" \
  -F "type=validation-schema"

​
Response

{
  "filename": "my-schema.json",
  "path": "s3://oss-config/validation-schema/my-schema.json"
}

​
Generate Schema from Sample Data

Use AI to generate a JSON Schema or XSD from sample data. The generated schema is stored in MinIO and can be referenced in pipeline configurations for data quality validation. 
POST /api/v1/config/generate-schema
Content-Type: application/json
FieldTypeRequiredDescription
typestringYesSchema type: json-schema or xsd
namestringYesName for the generated schema file
sampleDatastringYesSample data content for the AI to analyze

​
Example

curl -X POST http://localhost:8080/api/v1/config/generate-schema \
  -H "Content-Type: application/json" \
  -d '{
    "type": "json-schema",
    "name": "orders",
    "sampleData": "[{\"id\": 1, \"email\": \"jane@example.com\", \"total\": 249.99}]"
  }'

​
Response

{
  "filename": "orders.json",
  "path": "s3://oss-config/validation-schema/orders.json",
  "schema": "{ ... generated JSON Schema ... }"
}
For xsd type, the filename uses .xsd extension and the response contains a generated W3C XML Schema.