Preview

Process data using ingestion logic without saving it to a dataset.

POST /infer/preview

cURL

movies

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
  }
}
'

200

[
  {
    "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

bearerAuthopenId

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

200

application/json

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'"
  }
]