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

Beta Observability Campaigns Endpoints

(beta) Create and manage evaluation campaigns.

Get all campaigns

GET /v1/observability/campaigns

200

Successful Response

campaigns
*PaginatedResult_CampaignPreview_

Playground

Test the endpoints live

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

200

{
  "campaigns": {
    "count": 87
  }
}

Create and start a new campaign

POST /v1/observability/campaigns

201

Successful Response

created_at
*date-time
deleted_at
*date-time|null
description
*string
id
*string
judge
*JudgePreview
max_nb_events
*integer
name
*string
owner_id
*string
search_params
*FilterPayload
updated_at
*date-time
workspace_id
*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/campaigns \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "ipsum eiusmod",
  "judge_id": "consequat do",
  "max_nb_events": 87,
  "name": "reprehenderit ut dolore",
  "search_params": {
    "filters": null
  }
}'

201

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "deleted_at": null,
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "judge": {
    "created_at": "2025-10-07T20:56:01.974Z",
    "deleted_at": null,
    "description": "reprehenderit ut dolore",
    "id": "occaecat dolor sit",
    "instructions": "nostrud",
    "model_name": "aute aliqua aute commodo",
    "name": "irure",
    "output": {
      "options": [
        {
          "description": "dolor",
          "value": "sunt"
        }
      ]
    },
    "owner_id": "nisi minim commodo irure minim",
    "tools": [
      "do do sint mollit"
    ],
    "updated_at": "2025-10-07T20:56:01.974Z",
    "workspace_id": "occaecat"
  },
  "max_nb_events": 87,
  "name": "fugiat",
  "owner_id": "non nisi proident Lorem",
  "search_params": {
    "filters": null
  },
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud anim"
}

Get campaign by id

GET /v1/observability/campaigns/{campaign_id}

200

Successful Response

created_at
*date-time
deleted_at
*date-time|null
description
*string
id
*string
judge
*JudgePreview
max_nb_events
*integer
name
*string
owner_id
*string
search_params
*FilterPayload
updated_at
*date-time
workspace_id
*string

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/campaigns/{campaign_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",
  "judge": {
    "created_at": "2025-10-07T20:56:01.974Z",
    "deleted_at": null,
    "description": "reprehenderit ut dolore",
    "id": "occaecat dolor sit",
    "instructions": "nostrud",
    "model_name": "aute aliqua aute commodo",
    "name": "irure",
    "output": {
      "options": [
        {
          "description": "dolor",
          "value": "sunt"
        }
      ]
    },
    "owner_id": "nisi minim commodo irure minim",
    "tools": [
      "do do sint mollit"
    ],
    "updated_at": "2025-10-07T20:56:01.974Z",
    "workspace_id": "occaecat"
  },
  "max_nb_events": 87,
  "name": "fugiat",
  "owner_id": "non nisi proident Lorem",
  "search_params": {
    "filters": null
  },
  "updated_at": "2025-10-07T20:56:01.974Z",
  "workspace_id": "nostrud anim"
}

Delete a campaign

DELETE /v1/observability/campaigns/{campaign_id}

Playground

Test the endpoints live

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

Get campaign status by campaign id

GET /v1/observability/campaigns/{campaign_id}/status

200

Successful Response

status
*"RUNNING"|"COMPLETED"|"FAILED"|"CANCELED"|"TERMINATED"|"CONTINUED_AS_NEW"|"TIMED_OUT"|"UNKNOWN"

Playground

Test the endpoints live

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

200

{
  "status": "RUNNING"
}

Get event ids that were selected by the given campaign

GET /v1/observability/campaigns/{campaign_id}/selected-events

200

Successful Response

completion_events
*PaginatedResult_ChatCompletionEventPreview_

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/observability/campaigns/{campaign_id}/selected-events \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "completion_events": {
    "count": 87
  }
}