Skip to main content
POST
Create Skill

Overview

The Create Skill endpoint lets you add a new skill to your Mokaru account. Common use cases:
  • AI agent skill extraction - automatically add skills extracted from a job description or resume.
  • Profile enrichment - add newly acquired skills to your career profile.
  • Bulk import - add skills from an external source or assessment platform.
Scope required: skills:write | Rate limit: 20 requests/min

Request

Body Parameters

string
required
Skill name (max 200 characters)
string
Skill category. One of: TECHNICAL, SOFT, or LANGUAGE
string
Free-text level label, e.g. “Expert”, “Intermediate”. (max 50 characters)
number
Numeric proficiency 1-5.

Query Parameters

string
Target a specific resume by its id (from list-resumes). Omit to use your base/default resume; the resume must be self-contained.

Example

Response

boolean
Whether the skill was created
string
The new skill’s unique ID