Download OpenAPI Spec
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Beta Observability Datasets Records Endpoints

(beta) Manage individual records within datasets.

Get the content of a given conversation from a dataset

GET /v1/observability/dataset-records/{dataset_record_id}

200

Successful Response

created_at
*date-time
dataset_id
*string
deleted_at
*date-time|null
id
*string
payload
*ConversationPayload
properties
*map<any>
source
*"EXPLORER"|"UPLOADED_FILE"|"DIRECT_INPUT"|"PLAYGROUND"
updated_at
*date-time

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "dataset_id": "ipsum eiusmod",
  "deleted_at": null,
  "id": "consequat do",
  "payload": {
    "messages": [
      [
        null
      ]
    ]
  },
  "properties": [
    null
  ],
  "source": "EXPLORER",
  "updated_at": "2025-10-07T20:56:01.974Z"
}

Delete a record from a dataset

DELETE /v1/observability/dataset-records/{dataset_record_id}

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

Delete multiple records from datasets

POST /v1/observability/dataset-records/bulk-delete

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/dataset-records/bulk-delete \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "dataset_record_ids": [
    "ipsum eiusmod"
  ]
}'

Run Judge on a dataset record based on the given options

POST /v1/observability/dataset-records/{dataset_record_id}/live-judging

200

Successful Response

analysis
*string
answer
*string|number

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/live-judging \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "judge_definition": {
    "description": "ipsum eiusmod",
    "instructions": "consequat do",
    "model_name": "reprehenderit ut dolore",
    "name": "occaecat dolor sit",
    "output": {
      "options": [
        {
          "description": "nostrud",
          "value": "aute aliqua aute commodo"
        }
      ]
    },
    "tools": [
      "irure"
    ]
  }
}'

200

{
  "analysis": "ipsum eiusmod",
  "answer": "consequat do"
}

Update a dataset record conversation payload

PUT /v1/observability/dataset-records/{dataset_record_id}/payload

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/payload \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "payload": {
    "messages": [
      [
        null
      ]
    ]
  }
}'

Update conversation properties

PUT /v1/observability/dataset-records/{dataset_record_id}/properties

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/properties \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "properties": [
    null
  ]
}'