Update Classifier Label

PUThttps://api.confident-ai.com/v1/classifiers/{classifierId}/labels/{labelId}

Updates a label on a classifier. Only the fields you send are changed. Promoting a generated suggestion is an update to status ACTIVE. Requires the Starter plan or above.

PUT/v1/classifiers/{classifierId}/labels/{labelId}

curl -X PUT "https://api.confident-ai.com/v1/classifiers/{classifierId}/labels/{labelId}" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "ACTIVE"
}'

200

{
  "success": true,
  "data": {
    "label": {
      "id": "LABEL-ID",
      "name": "Positive",
      "description": "User expresses satisfaction or gratitude.",
      "enabled": true,
      "status": "ACTIVE",
      "polarity": "HIGHER_IS_BETTER"
    }
  },
  "link": "https://app.confident-ai.com/project/<PROJECT-ID>/workflows"
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Path parameters

classifierIdstringRequired
The unique identifier of the classifier.
labelIdstringRequired
The unique identifier of the label.

Request body

enabledboolean
Whether the label can be applied. Defaults to true.
statusenum
Setting ACTIVE also enables the label, so sending enabled false alongside it is rejected. Defaults to ACTIVE.
Show 2 enum valuesHide 2 enum values
- RECOMMENDED
- ACTIVE
polarityenum
Whether more of this label is good, bad, or neither. Defaults to NEUTRAL.
Show 3 enum valuesHide 3 enum values
- HIGHER_IS_BETTER
- LOWER_IS_BETTER
- NEUTRAL
namestring
A new name, unique within the classifier.
descriptionstring
When this label applies. Cannot be cleared.

Response

successboolean
Indicates if the request was successful.
dataobject
Show 1 propertyHide 1 property
- labelobject
  One label a classifier can apply.
  Show 6 propertiesHide 6 properties
  - idstring
    The unique identifier of the label.
  - namestring
    The label's name.
  - descriptionstring
    When this label applies. This is the instruction the classifying model reads, so it should describe the condition rather than restate the name.
  - enabledboolean
    Whether the label can be applied.
  - statusenum
    ACTIVE labels are in use; RECOMMENDED ones are generated suggestions awaiting review.
    Show 2 enum valuesHide 2 enum values
    RECOMMENDED
    ACTIVE
  - polarityenum
    Whether more of this label is good, bad, or neither, for trend reporting.
    Show 3 enum valuesHide 3 enum values
    HIGHER_IS_BETTER
    LOWER_IS_BETTER
    NEUTRAL
linkstring
A link to the workflows page.

Built byConfident AI