Files endpoint

Upload a file to Meridian for use across batch processing and fine-tuning jobs. The API accepts multipart form data with a purpose parameter that determines how the file is consumed downstream.

POST/v1/files

Content-Type: multipart/form-data

Request body

FieldTypeDescription
filebinaryThe file to upload. Supported formats: JSONL, CSV, TXT, PDF. Max size 512 MB.
purposestringIntended use. Accepted values: batch or fine-tune.

Example request

curl -X POST https://api.getnimbus.net/v1/files \
  -H "Authorization: Bearer $MERIDIAN_API_KEY" \
  -F "file=@training_data.jsonl" \
  -F "purpose=fine-tune"

Response

{
  "id": "file-abc123",
  "object": "file",
  "bytes": 140,
  "created_at": 1717027200,
  "filename": "training_data.jsonl",
  "purpose": "fine-tune",
  "status": "uploaded"
}

File status

uploaded

File received and stored.

processing

File is being validated and indexed.

ready

File is available for use.

error

File failed validation. Check the error field.

Notes

  • Files uploaded with purpose=batch are available for batch completion jobs within the same organization.
  • Files uploaded with purpose=fine-tune must pass format validation before they can be attached to a fine-tuning job.
  • All files are encrypted at rest and automatically deleted 30 days after their last use unless retention is extended via the dashboard.
← Back to docsBatch endpoint →