Excel/CSV → Markdown
Excel or CSV to Markdown
Endpoint
POST
https://claix.dev/api/excel-markdownTurns the first sheet of an .xlsx or CSV into a Markdown table. There is no schema and no model call: the file is parsed on the server, the same way Excel → JSON parses it before column mapping.
There is no schema_id. The Markdown is always returned. Send window_context=true to keep it for the window_time you choose; the response then includes document_id. space_id is optional and only applies when the document is kept: it attaches that document to the knowledge space.
1. Authentication
Same API key check as the JSON endpoints. The key must be active and the account status must be active.
x-api-key: <TU_API_KEY>
Or:
Authorization: Bearer <TU_API_KEY>
2. Parameters
| Field | Required | Description |
|---|---|---|
| file | Yes | Multipart file. .xlsx and .csv. If the workbook has several sheets, only the first one is processed. |
| window_context | No | true keeps the Markdown and returns document_id. Omit it or send false to only return the Markdown. |
| window_time | Required if window_context is true | Minutes: 5, 10, 15, 30, 45, 60, 90, 120, 180, 240, 360, 480, 720, 1440, or infinity. infinity requires Persistent Mode on the account. |
| space_id | No | UUID of a knowledge space owned by the API key. Only when window_context is true. The kept document is attached to that space. |
Model: No. The table is built locally.
3. Example
curl -X POST "https://claix.dev/api/excel-markdown" \ -H "x-api-key: TU_API_KEY" \ -F "file=@leads.xlsx" \ -F "window_context=true" \ -F "window_time=1440" \ -F "space_id=SPACE_UUID"
{
"success": true,
"markdown": "# Title\n\nBody...",
"document_id": "DOCUMENT_UUID",
"log_id": "LOG_UUID"
}4. Status codes
| Code | When |
|---|---|
| 200 | Markdown produced. Stored only when window_context is true. |
| 400 | Missing file or content, bad format, invalid window_time, space_id without window_context, or infinity without Persistent Mode. |
| 401 | API key missing, invalid, inactive, or account not active. |
| 404 | space_id does not exist for this account. |
| 405 | Method other than POST. |
| 413 | File or text over the same limit as the JSON endpoint. |
| 422 | Scanned PDF, image or audio rejected as unreadable, or empty Markdown. |
| 502 | The model call failed. |