SKILL: Skill
The SKILL entity: A skill classification with aliases for matching candidates to requirements using multiple naming variations.
SKILL definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches SKILL.Entity properties
| Property | Value |
|---|---|
| Entity code | SKILL |
| Display name | Skill |
| Plural | Skills |
| Level | 250 |
Use cases
SKILL stores a taxonomy of skills used for candidate matching, vacancy requirements, and search. Each skill has a canonical name, description, and an optional prefix for grouping or categorisation. The ten alias fields (alis1 through alis10) store alternative names, abbreviations, and variations for the same skill (e.g.
'JavaScript' might have aliases 'JS', 'ECMAScript', 'Node.js', 'NodeJS'). These aliases support fuzzy matching in search and candidate-to-vacancy matching algorithms, ensuring that different naming conventions used by candidates and hiring managers still produce correct matches. The multiple alias approach (rather than a separate alias entity) keeps the data flat and fast to query.
Fields
Skill
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name |
description | text (multi-line) | Description | |
prefix | text | Prefix | |
alis1 | text | Alias 1 | |
alis2 | text | Alias 2 | |
alis3 | text | Alias 3 | |
alis4 | text | Alias 4 | |
alis5 | text | Alias 5 | |
alis6 | text | Alias 6 | |
alis7 | text | Alias 7 | |
alis8 | text | Alias 8 | |
alis9 | text | Alias 9 | |
alis10 | text | Alias 10 |
Relationships
- No declared relationships in the default definition.
Creating a Skill via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "SKILL",
"level": 250,
"comboKey": "SUB:|ENT:",
"name": "Example name",
"description": "Example Description",
"prefix": "Example value",
"alis1": "Example value"
} Listing Skills records
GET /v1/entities/SKILL/SUB