Preview - Documentation

curl --request POST \ --url https://api.datalinks.com/api/v1/infer/preview \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "data": [ { "name": "Braveheart", "year": 1995, "budget": 72000000, "director": "Mel Gibson" }, { "name": "Argo", "year": 2012, "budget": 44500000, "director": "Ben Affleck" }, { "name": "A Quiet Place", "year": 2018, "budget": 17000000, "director": "John Krasinski" }, { "name": "Dances with Wolves", "year": 1990, "budget": 22000000, "director": "Kevin Costner" }, { "name": "Unforgiven", "year": 1992, "budget": 14000000, "director": "Clint Eastwood" }, { "name": "The Postman", "year": 1997, "budget": 80000000, "director": "Kevin Costner" } ], "link": { "ExactMatch": null } } '

[ { "id": "001", "__metadata_textToTable": "name -> John Smith, age -> 28, department -> Engineering", "name": "John Smith", "age": "28", "gender": "Male", "department": "Engineering", "location": "New York" }, { "id": "002", "__metadata_textToTable": "name -> Sarah Johnson, age -> 32, department -> Marketing", "name": "Sarah Johnson", "age": "32", "gender": "Female", "department": "Marketing", "location": "California" }, { "id": "003", "name": "Michael Brown", "age": "45", "gender": "Male", "department": "Finance", "location": "Texas", "__metadata_normalize": "Normalized department field from 'Fin Dept' to 'Finance'" } ]

Authorizations

Authorization

string

header

required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>.

Body

application/json

data

object[]

required

Show child attributes

infer

object

Show child attributes

link

object

Show child attributes

curate

boolean | null

dataDescription

string

A description of the dataset to help the AI system understand the context.

Maximum string length: 10000

Example:

"Employee dataset containing demographics and compensation."

schemaDefinition

object

A schema definition mapping field names to descriptions, to guide the AI system in structuring the extracted data.

Show child attributes

Example:

{
  "id": "unique employee identifier",
  "name": "full employee name",
  "age": "employee age in years",
  "department": "work department",
  "salary": "annual salary in USD"
}

additionalInstructions

string

Additional instructions to guide the AI system during ingestion.

Response

Returns the processed preview data.

Example:

[
  {
    "id": "001",
    "__metadata_textToTable": "name -> John Smith, age -> 28, department -> Engineering",
    "name": "John Smith",
    "age": "28",
    "gender": "Male",
    "department": "Engineering",
    "location": "New York"
  },
  {
    "id": "002",
    "__metadata_textToTable": "name -> Sarah Johnson, age -> 32, department -> Marketing",
    "name": "Sarah Johnson",
    "age": "32",
    "gender": "Female",
    "department": "Marketing",
    "location": "California"
  },
  {
    "id": "003",
    "name": "Michael Brown",
    "age": "45",
    "gender": "Male",
    "department": "Finance",
    "location": "Texas",
    "__metadata_normalize": "Normalized department field from 'Fin Dept' to 'Finance'"
  }
]