Concept

Update labels

PATCH
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_idstringRequired
The unique identifier for the concept

Request

This endpoint expects an object.
labels
list of objectsRequired
Labels for the concept. A label with an empty label value will delete any existing labels associate with the provided image or keyframe

Response

This endpoint returns an object
createdUserId
string
The user that created the resource
createdDt
datetime
The created datetime of the resource
updatedUserId
string
The user that last updated the resource
updatedDt
datetime
The datetime the resource was last updated
name
string
The name of the concept
conceptId
string
The unique identifier for the concept
datasetId
string
The unique identifier for the dataset
description
stringOptional
A description for the concept
threshold
doubleOptional
Threshold above which classification is positive
regularization
doubleOptional
How strongly the model adapts to the training labels. Regularization strength. Lower value means the model fits more heavily to the training data
PATCH
1curl -X PATCH https://app.coactive.ai/api/v1/concepts/string/labels \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "labels": [
6 {
7 "coactiveImageId": "a6894d72-612d-4c20-b4d0-8f3f21c2bb10",
8 "imagePath": "s3://coactive-public/logo.png",
9 "label": "positive"
10 }
11 ]
12}'
200Updated
1{
2 "createdUserId": "user_example",
3 "createdDt": "2018-09-11T15:11:45.456777",
4 "updatedUserId": "user_example",
5 "updatedDt": "2018-09-11T15:11:45.456777",
6 "name": "TheNorth",
7 "conceptId": "428e52cd-7ceb-490c-ae3f-0848c82d8c97",
8 "datasetId": "c40276f0-024b-4a3f-b3e6-dcf0d304843e",
9 "description": "Screenshots and clips from Game of Thrones that take place in the North",
10 "threshold": 0.8,
11 "regularization": 0.0625
12}