Update Classifier

curl -X PATCH https://api-gateway.merge.dev/v1/classifiers/classifier_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "description": "Finance team, including FP&A."
}'

{
  "build_error": null,
  "created_at": "2026-06-02T17:04:00Z",
  "description": "What counts as complex for the finance team.",
  "examples": [
    {
      "complexity": 0.05,
      "prompt": "What was our ARR at the end of Q3?"
    },
    {
      "complexity": 0.1,
      "prompt": "Who owns the intercompany elimination entries this quarter?"
    },
    {
      "complexity": 0.05,
      "prompt": "Send me the link to the FY26 opex budget."
    },
    {
      "complexity": 0.95,
      "prompt": "Reconcile Q3 deferred revenue against the billing schedules and explain every variance over $5k."
    },
    {
      "complexity": 0.9,
      "prompt": "Build the ARR bridge from Q2 to Q3 and tie it back to the GAAP revenue waterfall."
    },
    {
      "complexity": 0.95,
      "prompt": "Walk through the ASC 606 treatment of a 3-year ramp deal with a free first quarter."
    }
  ],
  "has_readout": true,
  "id": "5d7f9b1c-3e5a-4c7e-9a1b-6c8e0a2c4e69",
  "is_ready": true,
  "name": "Finance requests",
  "quality_report": {
    "accuracy": 1,
    "auc": 1,
    "examples": 6,
    "flagged_examples": [],
    "generic_accuracy": 0.83,
    "generic_auc": 0.89,
    "one_sided_terms": {
      "complex": [
        "revenue"
      ],
      "simple": []
    },
    "warnings": [
      "Add more examples: 10 or more on each side give steadier scores"
    ]
  },
  "status": "ready",
  "updated_at": "2026-09-14T09:30:00Z"
}

Update the fields you send. Sending examples replaces them and rebuilds the classifier in the background (status building); policies keep using the previous build until the new one is ready.

Authentication

AuthorizationBearer

A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.

Path parameters

classifier_idstringRequiredformat: "uuid"

The classifier’s id.

Request

This endpoint expects an object.

descriptionstring or nullOptional

What the classifier is for. Send "" to clear it. Omit, or send null, to keep the current value.

exampleslist of objects or nullOptional

Labeled prompts: what your requests look like and how complex each one is, from 0 (simple) to 1 (complex). Scores further from 0.5 count more. The classifier is ready once at least 3 are below 0.5 and 3 are at or above it. Omit, or send null, to keep the current value.

namestring or nullOptional1-255 characters

Unique within the organization. Omit, or send null, to keep the current value.

Response

The updated classifier

build_errorstring or nullRead-only

Why the last build failed, when status is failed.

created_atdatetimeRead-only

descriptionstring or null

What the classifier is for.

exampleslist of objects

has_readoutbooleanRead-only

Whether routers that score with the difficulty readout use it too. Classifiers saved before readouts get one when their examples are next updated.

idstringRead-onlyformat: "uuid"

Send as a routing policy’s complexity_classifier_id to use it.

is_readybooleanRead-only

Whether it has a build that scores requests (also true while a rebuild runs). A policy using a classifier that isn’t ready scores with the built-in scorer.

namestring

Unique within the organization.

quality_reportobject or nullRead-only

null until the classifier is ready.

statusenum

building while the classifier builds in the background after a save (a few seconds to a minute), then ready, or not_enough_examples when either side of 0.5 has fewer than 3 examples, or failed. While a rebuild runs, policies keep using the previous build.

Allowed values:

updated_atdatetimeRead-only

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error