Concept

Create concept

POST
Create a new concept

Request

This endpoint expects an object.
name
stringRequired
The name of the concept, which will become available as the column name in SQL
datasetId
stringRequired
The id of 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

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
POST
1curl -X POST https://app.coactive.ai/api/v1/concepts \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": "TheNorth",
6 "datasetId": "c40276f0-024b-4a3f-b3e6-dcf0d304843e",
7 "description": "Screenshots and clips from Game of Thrones that take place in the North",
8 "threshold": 0.8,
9 "regularization": 1
10}'
200
Successful
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": 1
12}