SkillMatchAction
Matches one or more search terms to active Skill records using exact, fuzzy, and (when generative AI is available) semantic matching, returning the matched skills grouped by term as JSON. Use this when terms are phrased loosely or in natural language. This is distinct from Search Skills, which is a deterministic partial-name lookup.
| Property | Value |
|---|
| Label | Match Skills |
| Category | Skills Extraction |
| Since | Summer 2026 |
| Read-only | Yes |
| Supports Agents | Yes |
| Supports Flows | No |
| Async Action | No |
| Keywords | extraction, resolve, identify, competency |
Request Parameters
| Field | Type | Label | Description | Required |
|---|
searchTerms | List<String> | Search Terms | The skill names or phrases to match (one match result is returned per term). | Yes |
excludedSkillIds | List<String> | Excluded Skill Ids | Optional. Ids of Skill records to exclude from the matches. | No |
roles | List<String> | Roles | Optional. Resource role names a matched skill must allow; a skill with no roles matches any role. | No |
validZoneSkillIds | List<String> | Valid Zone Skill Ids | Optional. Ids of skills within the allowed skill zones. When skill zones are enforced, leaving this empty returns only skills that have no zone. | No |
excludedRecordTypeIds | List<String> | Excluded Record Type Ids | Optional. Skill record type Ids to exclude from the matches. | No |
Response Parameters
| Field | Type | Label | Description | Required |
|---|
matchedSkills | String | Matched Skills | JSON array, one entry per search term: [{"searchTerm","matches":[{"skillId","skillName","matchStrength"}]}]. matchStrength is EXACT_MATCH or CLOSE_MATCH; matches are in relevance order. | No |
| 