Breaking Changes to the SkillsEngine API + New Translate Feature

We’ve just released an important update to the SkillsEngine API. This release introduces breaking changes that may affect any integrations you have built, as well as a new feature that improves how you work with skill profiles created through the Translate API.

See the latest API documentation →

Breaking Changes: What’s New & What You Need to Update:

We’ve made several structural improvements to our API schema for consistency and scalability. These changes affect the following endpoints:

• /skills/search
• /skill-sets/search
• /skill-profiles
• /skill-profiles/search
• /skill-profiles/{id}
• /api/translate

Key changes include:

• Response structure updated: Lists (e.g., skill profiles) are now returned under a parent key ("skill_profiles", "skill_sets", etc.).
• Field renames/removals:
  • creator_id, source, organization_id, created_at, and updated_at have been removed.
  • Replaced with unified fields like organization.name and last_modified.
• Flattened metadata: Metadata is now more streamlined but requires adjustments to client-side data parsing.

⚠️ These are breaking changes and will require updates to your API integrations. Please review the updated API documentation for complete details.

New Feature: Claiming Profiles from Translate API:

You can now view skill profiles created via the /api/translate endpoint and add them directly to your organization's account. Here's how it works:

1. When you call the Translate API, the response now includes a URL that looks like https://www.skillsengine.com/transferable/skill-profiles/529faacc-acef-42ab-a0dd-071dba455df5
2. Visit this URL in your browser.
3. Click the “Add to My Profiles” button.
4. Select the organization you want to assign the profile to.

Once claimed, the skill profile will be included in the results when using the /skill-profiles endpoint, just like any other manually created profile.

If you have any questions or need help updating your integration, don’t hesitate to reach out to our support team (support@skillsengine.com).