---
title: "Create Talent Traits"
method: POST
path: "/api/v2/insights/talent-traits"
tags: ["Insights"]
---

# Create Talent Traits

`POST /api/v2/insights/talent-traits`

Post a query with different filters for talent traits. All the values in the same filter is treated as an OR operation, while all the values in a different filter is treated as an AND operation.

## Headers

- `Authorization` string, required

## Request body

- TalentTraitsRequestSchema
  - `includeModels` string[], nullable — models that should be included
  - `query` string, nullable — query to be provided, can not be null
  - `filterLocation` string, nullable — To be provided to filter by Location
  - `filterSeniority` string[], nullable — To be provided to filter by Seniority
  - `filterTitle` string[], nullable — To be provided to filter by Title
  - `filterCompany` string[], nullable — To be provided to filter by Company

## Response `200`

OK

- TalentTraitSchema
  - `correctedQuery` string, nullable — corrected query for given query
  - `query` string, nullable — query for traits
  - `workCategories` TalentField[], nullable — work categories traits
    - `score` number, float, nullable — score of the parameter
    - `name` string, nullable — name for param
    - `logo` string, nullable — logo name for parent param
  - `work` TalentField[], nullable — work distribution
    - `score` number, float, nullable — score of the parameter
    - `name` string, nullable — name for param
    - `logo` string, nullable — logo name for parent param
  - `count` integer, nullable — total count
  - `school` TalentField[], nullable — school distribution
    - `score` number, float, nullable — score of the parameter
    - `name` string, nullable — name for param
    - `logo` string, nullable — logo name for parent param
  - `title` TalentField[], nullable — title for talent traits
    - `score` number, float, nullable — score of the parameter
    - `name` string, nullable — name for param
    - `logo` string, nullable — logo name for parent param
  - `skill` TalentField[], nullable — skills traits
    - `score` number, float, nullable — score of the parameter
    - `name` string, nullable — name for param
    - `logo` string, nullable — logo name for parent param

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)