Reference

REST API

Base URL: https://api.attos.io/v1

Authentication

bash

curl https://api.attos.io/v1/datasets \
  -H "Authorization: Bearer at_live_9f3a21b47c02"

POST /datasets/compile

bash

curl -X POST https://api.attos.io/v1/datasets/compile \
  -H "Authorization: Bearer $ATTOS_KEY" \
  -F "file=@users.csv" \
  -F "key_column=user_id"

Response

json

{
  "dataset_id": "ds_a1b2c3d4",
  "keys": 12400000,
  "artifact_url": "https://cdn.attos.io/ds_a1b2c3d4.nh",
  "size_bytes": 32505856,
  "compile_ms": 1912,
  "avg_lookup_ns": 19.7
}

Rate limits

1000 requests / minute per key. Compilation jobs are queued per project.