API Documentation

v1.0.0

Public API - Coming Soon

The Public API is currently in development and not yet available for use. This documentation is provided as a preview of upcoming capabilities.

Expected Release: 3-4 days

File Conversion API

Convert files programmatically with our simple REST API. Support for CSV, JSON, Excel, Parquet, and more.

Quick Start

Convert a CSV file to JSON in 4 simple steps

1. Get Upload URLs

Request signed URLs for uploading your source file and downloading the result

curl -X POST https://agentsfordata.com/api/public/v1/convert/upload-urls \
  -H "X-API-Key: tablab_api_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceFormat": "csv",
    "destinationFormat": "json",
    "filename": "my-data"
  }'

2. Upload Your File

Upload your CSV file to the signed URL from step 1

curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  -H "Content-Type: text/csv" \
  --data-binary @input.csv

3. Convert the File

Trigger the conversion using the file path from step 1

curl -X POST https://agentsfordata.com/api/public/v1/convert \
  -H "X-API-Key: tablab_api_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "FILE_PATH_FROM_STEP_1",
    "sourceFormat": "csv",
    "destinationFormat": "json",
    "filename": "my-data"
  }'

4. Download the Result

Download your converted JSON file from the URL returned in step 3

curl -o output.json "DOWNLOAD_URL_FROM_STEP_3"

Ready to try it? Check out the Getting Started guide for a complete walkthrough with example files.

Features

Multiple Formats

Convert between CSV, JSON, Excel, Parquet, TSV and more. Support for complex data types.

Fast & Reliable

High-performance conversions with automatic retries and error handling.

Secure

API key authentication with granular permissions and rate limiting.

Ready to Get Started?

API keys will be available when the Public API launches in 3-4 days.