---
title: "Update labels"
method: PATCH
path: "/api/v1/concepts/{concept_id}/labels"
tags: ["concept"]
---

# Update labels

`PATCH /api/v1/concepts/{concept_id}/labels`

Update labels for a concept. Label requests containing coactive image ids or image paths already in use will overwrite existing labels. Label requests with an empty label value will delete an existing label for that image/keyframe identifier.

## Path parameters

- `concept_id` string, uuid4, required

## Headers

- `Authorization` string, required

## Request body

- UpdateConceptLabelsRequest — An request to update labels for a concept
  - `labels` ConceptLabelRequest[], required — Labels for the concept. A label with an empty label value will delete any existing labels associate with the provided image or keyframe
    - `coactiveImageId` string, uuid4, nullable — The id of image or video keyframe to label
    - `imagePath` string, nullable — The path of an image to label
    - `label` 'positive' | 'negative' — Concept label values
  - `autosampledNumNegativeLabels` integer, nullable — The number of negative labels to add

## Response `200`

The updated concept

- Concept — Data about a concept that can be used to query a dataset
  - `createdUserId` string, required — The user that created the resource
  - `createdDt` string, date-time, required — The created datetime of the resource
  - `updatedUserId` string, required — The user that last updated the resource
  - `updatedDt` string, date-time, required — The datetime the resource was last updated
  - `name` string, required — The name of the concept
  - `description` string, nullable — A description for the concept
  - `threshold` number, double, nullable — Threshold above which classification is positive
  - `regularization` number, double, nullable — How strongly the model adapts to the training labels. Regularization strength. Lower value means the model fits more heavily to the training data
  - `conceptId` string, uuid4, required — The unique identifier for the concept
  - `datasetId` string, uuid4, required — The unique identifier for the dataset

## Other responses

- `404` — Concept not found
- `422` — Validation Error

---

[API](https://skmtc.net/coactive/apis/api-reference.md) · [All operations](https://skmtc.net/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coactive/api-reference/versions/c24e3835accc/schema)