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

Beta Observability Chat Completion Events Endpoints

(beta) Search, retrieve, and analyze chat completion events.

Get Chat Completion Events

POST /v1/observability/chat-completion-events/search

200

Successful Response

completion_events
*FeedResult_ChatCompletionEventPreview_

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/chat-completion-events/search \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "search_params": {
    "filters": null
  }
}'

200

{
  "completion_events": {}
}

Alternative to /search that returns only the IDs and that can return many IDs at once

POST /v1/observability/chat-completion-events/search-ids

200

Successful Response

completion_event_ids
*array<string>

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/chat-completion-events/search-ids \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "search_params": {
    "filters": null
  }
}'

200

{
  "completion_event_ids": [
    "ipsum eiusmod"
  ]
}

Get Chat Completion Event

GET /v1/observability/chat-completion-events/{event_id}

200

Successful Response

chat_transcription_events
*array<ChatTranscriptionEvent>
correlation_id
*string
created_at
*date-time
enabled_tools
*array<map<any>>
event_id
*string
extra_fields
*map<boolean|integer|number|string|date-time|array<string>|null>
nb_input_tokens
*integer
nb_messages
*integer
nb_output_tokens
*integer
request_messages
*array<map<any>>
response_messages
*array<map<any>>

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/chat-completion-events/{event_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "chat_transcription_events": [
    {
      "audio_url": "ipsum eiusmod",
      "model": "consequat do",
      "response_message": [
        null
      ]
    }
  ],
  "correlation_id": "reprehenderit ut dolore",
  "created_at": "2025-10-07T20:56:01.974Z",
  "enabled_tools": [
    [
      null
    ]
  ],
  "event_id": "occaecat dolor sit",
  "extra_fields": [
    null
  ],
  "nb_input_tokens": 87,
  "nb_messages": 14,
  "nb_output_tokens": 56,
  "request_messages": [
    [
      null
    ]
  ],
  "response_messages": [
    [
      null
    ]
  ]
}

Get Similar Chat Completion Events

GET /v1/observability/chat-completion-events/{event_id}/similar-events

200

Successful Response

completion_events
*FeedResult_ChatCompletionEventPreview_

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/chat-completion-events/{event_id}/similar-events \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "completion_events": {}
}

Run Judge on an event based on the given options

POST /v1/observability/chat-completion-events/{event_id}/live-judging

200

Successful Response

analysis
*string
answer
*string|number

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/chat-completion-events/{event_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"
}