---
title: "Create concept"
method: POST
path: "/api/v1/concepts"
tags: ["concept"]
---

# Create concept

`POST /api/v1/concepts`

Create a new concept

## Headers

- `Authorization` string, required

## Request body

- CreateConceptRequest — An object used to create a concept in Coactive's system
  - `name` string, required — The name of the concept, which will become available as the column name in SQL
  - `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
  - `datasetId` string, uuid4, required — The id of the dataset

## Response `200`

The created 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

- `400` — Invalid concept name
- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)