Skip to main content
PUT
/
data
/
{username}
/
{namespace}
/
{datasetName}
/
inferDefinition
Update inference definition
curl --request PUT \
  --url https://api.datalinks.com/api/v1/data/{username}/{namespace}/{datasetName}/inferDefinition \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataDescription": "Employee dataset containing demographics and compensation.",
  "schemaDefinition": {
    "id": "unique employee identifier",
    "name": "full employee name",
    "age": "employee age in years",
    "department": "work department",
    "salary": "annual salary in USD"
  }
}
'

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
namespace
string
required

Namespace for the dataset.

​
datasetName
string
required

Name of the dataset.

​
username
string
required

The username associated with the request.

Body

application/json
​
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.

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

Response

Creates a new inference definition.