Skills
This endpoint manages skills associated with talent profiles.
Overview
The Skills API allows you to create, update, and manage skills that are linked to talent profiles. Skills represent specific competencies, technical abilities, or knowledge areas that talents possess, and are a key component of talent matching and development.
Skill Management
Skills in the system can include:
- Technical skills (programming languages, tools, platforms)
- Soft skills (communication, leadership, teamwork)
- Domain knowledge (industry-specific expertise)
- Methodologies and frameworks
Key Features
- Associate skills with talent profiles
- Track proficiency levels for each skill
- Manage skill categories and hierarchies
- Support skill-based talent search and matching
Relationships
Each skill record is associated with a specific talent profile. When creating a new skill, you must specify the talent it belongs to using the relationship field.
Endpoints
- get /api/v3/talent/skills
- post /api/v3/talent/skills
- delete /api/v3/talent/skills/:resource_id
- get /api/v3/talent/skills/:resource_id
- patch /api/v3/talent/skills/:resource_id
get/api/v3/talent/skills
Return a paginated list of talent/skills
Input Schema
Typescript
object
page?:
object
The page number, default to 1
number?: integer
The number of items per page, default to 1000
size?: integer
The sort order, comma separated list of fields. See sorting section for more details
sort?: string
Set to true to return the total number of items in the collection
count?: boolean
filter?:
object
id?: unknown
talent_id?: unknown
name?: unknown
level?: unknown
The related resources to include in the response. Allowed resources are:
- `talent`
included?: - `talent`
array
Elements: string
The fields to include in the response.
The key is the resource type and the value is an array of fields.
fields?: The key is the resource type and the value is an array of fields.
dictionary
Values: array
Output Schema
Typescript
object
data:
array
Elements:
object
type: string
id?: string
attributes?:
object
id?: integer
name?: string
level?: integer
relationships?: open struct
included?:
array
Elements: open struct
post/api/v3/talent/skills
Create a new talent/skills
Input Schema
Typescript
object
data:
object
type: string
attributes:
object
id?: integer
name?: string
level?: integer
relationships?:
object
talent:
object
data:
object
type: string
id?: string
delete/api/v3/talent/skills/:resource_id
Delete the talent/skills
Input Schema
Typescript
object
resource_id: integer
get/api/v3/talent/skills/:resource_id
Show a specific talent/skills
Input Schema
Typescript
object
resource_id: integer
included?:
array
Elements: string
fields?:
dictionary
Values: array
Output Schema
Typescript
object
data:
object
type: string
id?: string
attributes?:
object
id?: integer
name?: string
level?: integer
relationships?: open struct
included?:
array
Elements: open struct
patch/api/v3/talent/skills/:resource_id
Update a talent/skills
Input Schema
Typescript
object
resource_id: integer
data:
object
type: string
attributes:
object
id?: integer
name?: string
level?: integer