fix: rewrite Arc Cloud docs with correct API endpoints

Replace made-up /api/v1/ingest and /api/v1/sql endpoints with real Arc API:
- MessagePack (/api/v1/write/msgpack) as primary ingestion
- Line protocol (/api/v1/write/line-protocol) for Telegraf/InfluxDB compat
- SQL query (/api/v1/query) with JSON and Arrow response formats
- Bulk import: CSV, Parquet, InfluxDB line protocol migration

New docs:
- Integrations guide (Telegraf, InfluxDB clients, OTEL, Vector, MQTT, SDK)
- Migration guide (InfluxDB, CSV, Parquet import)

Updated: overview pricing, quickstart, all guides, API reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Ignacio Van Droogenbroeck

docs-arc-cloud/api-reference/overview.md

@@ -4,7 +4,7 @@ sidebar_position: 1
 
 # API Reference
 
-Arc Cloud instances expose the same HTTP API as self-hosted Arc. Any Arc client, SDK, or integration that works with Arc will work with Arc Cloud without modification.
+Arc Cloud instances expose the full Arc HTTP API. Any Arc client, SDK, or integration that works with Arc will work with Arc Cloud without modification -- including InfluxDB-compatible endpoints.
 
 ## Base URL
 
@@ -24,65 +24,154 @@ You can find your instance's base URL on the dashboard overview page.
 
 ## Authentication
 
-All API requests (except the health check) require a Bearer token in the `Authorization` header:
+All API requests (except `/health`) require authentication. Arc Cloud supports multiple authentication methods:
 
+| Method | Header / Param | Example |
+|--------|---------------|---------|
+| Bearer token (standard) | `Authorization: Bearer TOKEN` | Most clients and SDKs |
+| Token prefix (InfluxDB 2.x) | `Authorization: Token TOKEN` | InfluxDB 2.x client libraries |
+| API key header | `x-api-key: TOKEN` | Programmatic access |
+| Query parameter (InfluxDB 1.x) | `?p=TOKEN` | Legacy InfluxDB 1.x tools |
+
+Generate API tokens from **Settings > API Tokens** in your instance dashboard.
+
+## Key Endpoints
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/health` | GET | Health check (no auth required) |
+| `/api/v1/write/msgpack` | POST | MessagePack ingestion (fastest) |
+| `/api/v1/write/line-protocol` | POST | Line protocol ingestion |
+| `/write` | POST | InfluxDB 1.x compatible write |
+| `/api/v2/write` | POST | InfluxDB 2.x compatible write |
+| `/api/v1/query` | POST | SQL query (JSON response) |
+| `/api/v1/query/arrow` | POST | SQL query (Arrow response) |
+| `/api/v1/import/csv` | POST | CSV bulk import |
+| `/api/v1/import/parquet` | POST | Parquet bulk import |
+| `/api/v1/import/lp` | POST | Line protocol bulk import |
+| `/api/v1/databases` | GET | List databases |
+| `/api/v1/measurements` | GET | List measurements |
+
+## Examples
+
+### Health Check
+
+```bash
+curl https://abc123.arc.us-east-1.basekick.net/health
 ```
-Authorization: Bearer <token>
+
+### Write Data (Line Protocol)
+
+```bash
+curl -X POST https://abc123.arc.us-east-1.basekick.net/api/v1/write/line-protocol \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: text/plain" \
+  -d 'cpu,host=server01 usage=0.64 1711180800000000000
+cpu,host=server02 usage=0.38 1711180800000000000'
 ```
 
-Generate API tokens from the **Settings > API Tokens** section of your instance dashboard.
+### Write Data (MessagePack)
 
-## Key Endpoints
+MessagePack is the fastest ingestion path. Use the Arc SDK or serialize your data as MessagePack and POST to the endpoint:
 
-| Method | Endpoint | Description | Auth Required |
-|--------|----------|-------------|---------------|
-| `POST` | `/api/v1/sql` | Execute SQL queries | Yes |
-| `POST` | `/api/v1/ingest` | Ingest records | Yes |
-| `GET` | `/health` | Health check | No |
-| `GET` | `/api/v1/databases` | List databases | Yes |
-| `GET` | `/api/v1/databases/:name/tables` | List tables in a database | Yes |
+```bash
+curl -X POST https://abc123.arc.us-east-1.basekick.net/api/v1/write/msgpack \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/msgpack" \
+  --data-binary @data.msgpack
+```
+
+### Write Data (InfluxDB 2.x Compatible)
+
+```bash
+curl -X POST "https://abc123.arc.us-east-1.basekick.net/api/v2/write?bucket=mydb&precision=ns" \
+  -H "Authorization: Token <token>" \
+  -H "Content-Type: text/plain" \
+  -d 'cpu,host=server01 usage=0.64 1711180800000000000'
+```
+
+### Write Data (InfluxDB 1.x Compatible)
+
+```bash
+curl -X POST "https://abc123.arc.us-east-1.basekick.net/write?db=mydb&p=<token>" \
+  -H "Content-Type: text/plain" \
+  -d 'cpu,host=server01 usage=0.64 1711180800000000000'
+```
 
-### Execute SQL
+### SQL Query (JSON)
 
 ```bash
-curl -X POST https://<instance-id>.arc.<region>.basekick.net/api/v1/sql \
+curl -X POST https://abc123.arc.us-east-1.basekick.net/api/v1/query \
   -H "Authorization: Bearer <token>" \
   -H "Content-Type: application/json" \
-  -d '{"query": "SELECT * FROM analytics.events LIMIT 10"}'
+  -d '{"q": "SELECT * FROM cpu WHERE host = '\''server01'\'' LIMIT 10"}'
 ```
 
-### Ingest Records
+### SQL Query (Arrow)
+
+For large result sets, the Arrow response format is significantly more efficient:
 
 ```bash
-curl -X POST https://<instance-id>.arc.<region>.basekick.net/api/v1/ingest \
+curl -X POST https://abc123.arc.us-east-1.basekick.net/api/v1/query/arrow \
   -H "Authorization: Bearer <token>" \
   -H "Content-Type: application/json" \
-  -d '{
-    "database": "analytics",
-    "table": "events",
-    "records": [
-      {"timestamp": "2026-03-23T12:00:00Z", "event": "page_view", "page": "/home"}
-    ]
-  }'
+  -d '{"q": "SELECT * FROM cpu ORDER BY time DESC LIMIT 1000"}' \
+  --output results.arrow
+```
+
+### List Databases
+
+```bash
+curl https://abc123.arc.us-east-1.basekick.net/api/v1/databases \
+  -H "Authorization: Bearer <token>"
+```
+
+### List Measurements
+
+```bash
+curl "https://abc123.arc.us-east-1.basekick.net/api/v1/measurements?db=mydb" \
+  -H "Authorization: Bearer <token>"
+```
+
+### Bulk Import (CSV)
+
+```bash
+curl -X POST "https://abc123.arc.us-east-1.basekick.net/api/v1/import/csv?db=mydb&measurement=sensors&time_column=timestamp" \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: text/csv" \
+  --data-binary @data.csv
+```
+
+### Bulk Import (Parquet)
+
+```bash
+curl -X POST "https://abc123.arc.us-east-1.basekick.net/api/v1/import/parquet?db=mydb&measurement=sensors" \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/octet-stream" \
+  --data-binary @data.parquet
 ```
 
 ## Response Format
 
-All API responses return JSON with the following structure:
+JSON query responses (`/api/v1/query`) return the following structure:
 
 ```json
 {
-  "success": true,
-  "data": [...],
-  "columns": ["column_name", "column_type"]
+  "columns": ["time", "host", "usage"],
+  "types": ["timestamp", "string", "float64"],
+  "data": [
+    ["2026-03-23T12:00:00Z", "server01", 0.64],
+    ["2026-03-23T12:00:00Z", "server02", 0.38]
+  ],
+  "row_count": 2,
+  "execution_time_ms": 3
 }
 ```
 
 On error:
 
 ```json
 {
-  "success": false,
   "error": "Description of the error"
 }
 ```
@@ -93,6 +182,4 @@ Rate limits vary by tier. When you exceed your tier's ingest rate, the API retur
 
 ## Full API Documentation
 
-The Arc Cloud API is identical to the self-hosted Arc API. For complete endpoint documentation, request/response schemas, and advanced usage, see the [Arc API Reference](/arc/api-reference).
-
-Any Arc client or SDK works with Arc Cloud — just point it at your instance's base URL and provide your API token.
+For complete endpoint documentation, request/response schemas, and advanced usage, see the [Arc API Reference](/arc/api-reference).

docs-arc-cloud/getting-started/quickstart.md

@@ -34,41 +34,62 @@ The admin token is shown **only once** during provisioning. Copy it immediately
 Verify your instance is running with a simple query:
 
 ```bash
-curl -X POST https://<instance-id>.arc.<region>.basekick.net/api/v1/sql \
+curl -X POST "https://<your-instance>.arc.us-east-1.basekick.net/api/v1/query" \
   -H "Authorization: Bearer <your-token>" \
   -H "Content-Type: application/json" \
-  -d '{"query": "SELECT 1 AS hello"}'
+  -d '{"sql": "SELECT 1 AS hello", "format": "json"}'
 ```
 
 You should receive a JSON response with the result `hello: 1`.
 
 ## 6. Ingest Data
 
-Send your first records to Arc Cloud:
+Send your first records to Arc Cloud using line protocol, the simplest way to write data via `curl`:
 
 ```bash
-curl -X POST https://<instance-id>.arc.<region>.basekick.net/api/v1/ingest \
+curl -X POST "https://<your-instance>.arc.us-east-1.basekick.net/api/v1/write/line-protocol" \
   -H "Authorization: Bearer <your-token>" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "database": "my_app",
-    "records": [
-      {"timestamp": "2026-03-23T12:00:00Z", "event": "page_view", "user_id": "u123", "page": "/home"}
-    ]
-  }'
+  -H "Content-Type: text/plain" \
+  -H "x-arc-database: default" \
+  -d 'events,source=web page_view=1,user_id="u123",page="/home" 1711180800000000000'
 ```
 
 Arc Cloud automatically creates the database and table on first write.
 
+:::tip MessagePack for Production
+Line protocol is convenient for quick tests. For production workloads, use the MessagePack endpoint (`POST /api/v1/write/msgpack`) with columnar format for higher throughput and lower overhead. See the [Arc API Reference](/arc/api-reference) for details.
+:::
+
 ## 7. Query Your Data
 
 Retrieve the data you just ingested:
 
 ```bash
-curl -X POST https://<instance-id>.arc.<region>.basekick.net/api/v1/sql \
+curl -X POST "https://<your-instance>.arc.us-east-1.basekick.net/api/v1/query" \
   -H "Authorization: Bearer <your-token>" \
   -H "Content-Type: application/json" \
-  -d '{"query": "SELECT * FROM my_app.events LIMIT 10"}'
+  -d '{"sql": "SELECT * FROM default.events LIMIT 10", "format": "json"}'
+```
+
+## 8. Use the Python SDK
+
+Arc Cloud exposes the same API as Arc OSS, so all Arc clients and SDKs work without modification. Install the Python SDK:
+
+```bash
+pip install arc-tsdb-client[all]
+```
+
+```python
+from arc_tsdb_client import ArcClient
+
+client = ArcClient(
+    url="https://<your-instance>.arc.us-east-1.basekick.net",
+    token="<your-token>",
+)
+
+# Query
+result = client.query("SELECT * FROM default.events LIMIT 10")
+print(result)
 ```
 
 ## Next Steps