API ReferenceSplitting
Split Async
Start an asynchronous document splitting job
POST
/api/v1/split/{splitterId}/asyncASYNCStarts splitting a file asynchronously. Returns immediately with a splitId that can be used to poll for results via the get-split endpoint. Returns 409 if a split is already in progress for the file.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
splitterId | string | path | Yes | The splitter ID |
fileId | string | body | Yes | ID of the uploaded file (from get-url) |
Request
const res = await fetch(
"https://app.limai.io/api/v1/split/spl_abc123/async",
{
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json",
},
body: JSON.stringify({ fileId: "cuid_file_123" }),
}
);
const { splitId, status } = await res.json();Response
Response200
{
"splitId": "split_abc123",
"status": "PROCESSING",
"message": "Split job started successfully"
}