Beta Observability Datasets Endpoints

(beta) Create, update, import, and export datasets.

List existing datasets

GET /v1/observability/datasets

200

Successful Response

datasets

*PaginatedResult_DatasetPreview_

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/observability/datasets \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "datasets": {
    "count": 87
  }
}

{
  "datasets": {
    "count": 87
  }
}

Create a new empty dataset

POST /v1/observability/datasets

201

Successful Response

created_at

*date-time

deleted_at

*date-time|null

description

*string

id

*string

name

*string

owner_id

*string

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "ipsum eiusmod",
  "name": "consequat do"
}'

curl https://api.mistral.ai/v1/observability/datasets \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "ipsum eiusmod",
  "name": "consequat do"
}'

201

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "name": "reprehenderit ut dolore",
  "owner_id": "occaecat dolor sit",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "name": "reprehenderit ut dolore",
  "owner_id": "occaecat dolor sit",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud"
}

Get dataset by id

GET /v1/observability/datasets/{dataset_id}

200

Successful Response

created_at

*date-time

deleted_at

*date-time|null

description

*string

id

*string

name

*string

owner_id

*string

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

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

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

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "name": "reprehenderit ut dolore",
  "owner_id": "occaecat dolor sit",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "name": "reprehenderit ut dolore",
  "owner_id": "occaecat dolor sit",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud"
}

Delete a dataset

DELETE /v1/observability/datasets/{dataset_id}

Playground

Test the endpoints live

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

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

Patch dataset

PATCH /v1/observability/datasets/{dataset_id}

200

Successful Response

created_at

*date-time

deleted_at

*date-time|null

description

*string

id

*string

name

*string

owner_id

*string

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id} \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id} \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "name": "reprehenderit ut dolore",
  "owner_id": "occaecat dolor sit",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "name": "reprehenderit ut dolore",
  "owner_id": "occaecat dolor sit",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud"
}

List existing records in the dataset

GET /v1/observability/datasets/{dataset_id}/records

200

Successful Response

records

*PaginatedResult_DatasetRecord_

Playground

Test the endpoints live

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

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

200

{
  "records": {
    "count": 87
  }
}

{
  "records": {
    "count": 87
  }
}

Add a conversation to the dataset

POST /v1/observability/datasets/{dataset_id}/records

201

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/datasets/{dataset_id}/records \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "payload": {
    "messages": [
      [
        null
      ]
    ]
  },
  "properties": [
    null
  ]
}'

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

201

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

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

Populate the dataset with a campaign

POST /v1/observability/datasets/{dataset_id}/imports/from-campaign

202

Successful Response

created_at

*date-time

creator_id

*string

dataset_id

*string

deleted_at

*date-time|null

id

*string

message

string|null

progress

integer|null

status

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-campaign \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "campaign_id": "ipsum eiusmod"
}'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-campaign \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "campaign_id": "ipsum eiusmod"
}'

202

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

Populate the dataset with samples from the explorer

POST /v1/observability/datasets/{dataset_id}/imports/from-explorer

202

Successful Response

created_at

*date-time

creator_id

*string

dataset_id

*string

deleted_at

*date-time|null

id

*string

message

string|null

progress

integer|null

status

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-explorer \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "completion_event_ids": [
    "ipsum eiusmod"
  ]
}'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-explorer \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "completion_event_ids": [
    "ipsum eiusmod"
  ]
}'

202

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

Populate the dataset with samples from an uploaded file

POST /v1/observability/datasets/{dataset_id}/imports/from-file

202

Successful Response

created_at

*date-time

creator_id

*string

dataset_id

*string

deleted_at

*date-time|null

id

*string

message

string|null

progress

integer|null

status

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-file \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "file_id": "ipsum eiusmod"
}'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-file \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "file_id": "ipsum eiusmod"
}'

202

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

Populate the dataset with samples from the playground

POST /v1/observability/datasets/{dataset_id}/imports/from-playground

202

Successful Response

created_at

*date-time

creator_id

*string

dataset_id

*string

deleted_at

*date-time|null

id

*string

message

string|null

progress

integer|null

status

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-playground \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "conversation_ids": [
    "ipsum eiusmod"
  ]
}'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/imports/from-playground \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "conversation_ids": [
    "ipsum eiusmod"
  ]
}'

202

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

Populate the dataset with samples from another dataset

POST /v1/observability/datasets/{dataset_id}/imports/from-dataset

202

Successful Response

created_at

*date-time

creator_id

*string

dataset_id

*string

deleted_at

*date-time|null

id

*string

message

string|null

progress

integer|null

status

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

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

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

202

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

Export to the Files API and retrieve presigned URL to download the resulting JSONL file

GET /v1/observability/datasets/{dataset_id}/exports/to-jsonl

200

Successful Response

file_url

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/exports/to-jsonl \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/exports/to-jsonl \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "file_url": "ipsum eiusmod"
}

{
  "file_url": "ipsum eiusmod"
}

Get status of a dataset import task

GET /v1/observability/datasets/{dataset_id}/tasks/{task_id}

200

Successful Response

created_at

*date-time

creator_id

*string

dataset_id

*string

deleted_at

*date-time|null

id

*string

message

string|null

progress

integer|null

status

updated_at

*date-time

workspace_id

*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/tasks/{task_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/tasks/{task_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "creator_id": "ipsum eiusmod",
  "dataset_id": "consequat do",
  "deleted_at": null,
  "id": "reprehenderit ut dolore",
  "status": "RUNNING",
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "occaecat dolor sit"
}

List import tasks for the given dataset

GET /v1/observability/datasets/{dataset_id}/tasks

200

Successful Response

tasks

*PaginatedResult_DatasetImportTask_

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/tasks \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/observability/datasets/{dataset_id}/tasks \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "tasks": {
    "count": 87
  }
}

{
  "tasks": {
    "count": 87
  }
}

Beta Observability Datasets Endpoints

Examples

GET /v1/observability/datasets

Parameters

page_size

page

q

datasets

Playground

POST /v1/observability/datasets

Request Body

description

name

created_at

deleted_at

description

id

name

owner_id

updated_at

workspace_id

Playground

GET /v1/observability/datasets/{dataset_id}

Parameters

dataset_id

created_at

deleted_at

description

id

name

owner_id

updated_at

workspace_id

Playground

DELETE /v1/observability/datasets/{dataset_id}

Parameters

dataset_id

Playground

PATCH /v1/observability/datasets/{dataset_id}

Parameters

dataset_id

Request Body

description

name

created_at

deleted_at

description

id

name

owner_id

updated_at

workspace_id

Playground

GET /v1/observability/datasets/{dataset_id}/records

Parameters

dataset_id

page_size

page

records

Playground

POST /v1/observability/datasets/{dataset_id}/records

Parameters

dataset_id

Request Body

payload

properties

created_at

dataset_id

deleted_at

id

payload

properties

source

updated_at

Playground

POST /v1/observability/datasets/{dataset_id}/imports/from-campaign

Parameters

dataset_id

Request Body

campaign_id