Track Changes - Datalab Documentation

POST

api

track-changes

Track Changes

import requests

url = "https://www.datalab.to/api/v1/track-changes"

files = { "file.0": ("example-file", open("example-file", "rb")) }
payload = {
    "file_url": "<string>",
    "output_format": "markdown,html,chunks",
    "max_pages": "123",
    "page_range": "<string>",
    "paginate": "false",
    "skip_cache": "false",
    "webhook_url": "<string>",
    "processing_location": "<string>",
    "workflowstepdata_id": "123",
    "model_override_settings": "<string>",
    "file": "<string>"
}
headers = {"X-API-Key": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

curl --request POST \
  --url https://www.datalab.to/api/v1/track-changes \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'file_url=<string>' \
  --form 'output_format=markdown,html,chunks' \
  --form max_pages=123 \
  --form 'page_range=<string>' \
  --form paginate=false \
  --form skip_cache=false \
  --form 'webhook_url=<string>' \
  --form 'processing_location=<string>' \
  --form workflowstepdata_id=123 \
  --form 'model_override_settings=<string>' \
  --form 'file=<string>' \
  --form file.0='@example-file'

const form = new FormData();
form.append('file_url', '<string>');
form.append('output_format', 'markdown,html,chunks');
form.append('max_pages', '123');
form.append('page_range', '<string>');
form.append('paginate', 'false');
form.append('skip_cache', 'false');
form.append('webhook_url', '<string>');
form.append('processing_location', '<string>');
form.append('workflowstepdata_id', '123');
form.append('model_override_settings', '<string>');
form.append('file', '<string>');
form.append('file.0', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

options.body = form;

fetch('https://www.datalab.to/api/v1/track-changes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.datalab.to/api/v1/track-changes"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_format\"\r\n\r\nmarkdown,html,chunks\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"max_pages\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page_range\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"paginate\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"skip_cache\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"processing_location\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"workflowstepdata_id\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model_override_settings\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file.0\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "request_id": "<string>",
  "request_check_url": "<string>",
  "success": true,
  "error": "<string>",
  "versions": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Cookies

wos-session

string

datalab_active_team

string

Body

multipart/form-data

file_url

string | null

Optional file URL (http/https). If provided, the server will download and process it.

output_format

string

default:markdown,html,chunks

Comma-separated output formats. Supports: markdown, html, chunks.

max_pages

integer | null

The maximum number of pages to process.

page_range

string | null

The page range to process, comma separated like 0,5-10,20.

paginate

boolean

default:false

Whether to separate the output by page with horizontal rules.

skip_cache

boolean

default:false

Skip the cache and re-run the inference.

webhook_url

string | null

Optional webhook URL to call when the request is complete.

processing_location

string | null

Optional residency region override (e.g. us, eu). When provided, use file_url or direct-upload; multipart uploads are rejected. When omitted, the request uses the team's configured residency and profile.

workflowstepdata_id

integer | null

model_override_settings

string | null

file

file | null

Input PDF, word document, powerpoint, or image file, uploaded as multipart form data. Images must be png, jpg, or webp format.

Response

Successful Response

request_id

string

required

The ID of the request. This ID can be used to check the status of the request.

request_check_url

string

required

The URL to check the status of the request and get results.

success

boolean

default:true

Whether the request was successful.

error

string | null

If the request was not successful, this will contain an error message.

versions

A dictionary of the versions of the libraries used in the request.

Thumbnails

⌘I

Track Changes

import requests

url = "https://www.datalab.to/api/v1/track-changes"

files = { "file.0": ("example-file", open("example-file", "rb")) }
payload = {
    "file_url": "<string>",
    "output_format": "markdown,html,chunks",
    "max_pages": "123",
    "page_range": "<string>",
    "paginate": "false",
    "skip_cache": "false",
    "webhook_url": "<string>",
    "processing_location": "<string>",
    "workflowstepdata_id": "123",
    "model_override_settings": "<string>",
    "file": "<string>"
}
headers = {"X-API-Key": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

curl --request POST \
  --url https://www.datalab.to/api/v1/track-changes \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'file_url=<string>' \
  --form 'output_format=markdown,html,chunks' \
  --form max_pages=123 \
  --form 'page_range=<string>' \
  --form paginate=false \
  --form skip_cache=false \
  --form 'webhook_url=<string>' \
  --form 'processing_location=<string>' \
  --form workflowstepdata_id=123 \
  --form 'model_override_settings=<string>' \
  --form 'file=<string>' \
  --form file.0='@example-file'

const form = new FormData();
form.append('file_url', '<string>');
form.append('output_format', 'markdown,html,chunks');
form.append('max_pages', '123');
form.append('page_range', '<string>');
form.append('paginate', 'false');
form.append('skip_cache', 'false');
form.append('webhook_url', '<string>');
form.append('processing_location', '<string>');
form.append('workflowstepdata_id', '123');
form.append('model_override_settings', '<string>');
form.append('file', '<string>');
form.append('file.0', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

options.body = form;

fetch('https://www.datalab.to/api/v1/track-changes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.datalab.to/api/v1/track-changes"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"output_format\"\r\n\r\nmarkdown,html,chunks\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"max_pages\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page_range\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"paginate\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"skip_cache\"\r\n\r\nfalse\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"processing_location\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"workflowstepdata_id\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"model_override_settings\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file.0\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "request_id": "<string>",
  "request_check_url": "<string>",
  "success": true,
  "error": "<string>",
  "versions": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}