---
title: "Add a Skill to a Job Role"
method: POST
path: "/api/v2/job-roles/add-skills"
tags: ["Job Roles"]
---

# Add a Skill to a Job Role

`POST /api/v2/job-roles/add-skills`

This endpoint adds skills to a job role. <h3>Required Scope</h3>`job_roles:write`

## Request body

- JobrolesAddskillsBody
  - `data` Apiv2jobrolesaddskillsData
    - `type` string — The resource type identifier for the job role skills assignment.
    - `attributes` Apiv2jobrolesaddskillsDataAttributes
      - `role-id` string, required — The ID of the job role to which the skills are being added.
      - `skills` Apiv2jobrolesaddskillsDataAttributesSkills[] — A list of skills to associate with the specified job role.
        - `type` string, required — The related resource type.
        - `id` string, required — The name of the skill.
        - `meta` Apiv2jobrolesaddskillsDataAttributesMeta — Metadata describing the relationship between the job role and the skill.
          - `target-level` integer — The target proficiency level expected for the skill.
          - `priority` integer — Indicates whether the skill is considered a priority for the organization (0 = not a priority, 1 = priority).

## Response `200`

Success

- InlineResponse20027
  - `data` InlineResponse20027Data
    - `type` string — The resource type identifier for the job role skills.
    - `id` string, nullable — The unique identifier of the resource.
    - `attributes` InlineResponse20027DataAttributes
      - `role-id` string — The ID of the job role associated with the skills.
      - `skills` InlineResponse20027DataAttributesSkills[] — A list of skills associated with the job role.
        - `type` string — The related resource type.
        - `id` string — The name of the skill.
        - `meta` Apiv2jobrolesaddskillsDataAttributesMeta — Metadata describing the relationship between the job role and the skill.
          - `target-level` integer — The target proficiency level expected for the skill.
          - `priority` integer — Indicates whether the skill is considered a priority for the organization (0 = not a priority, 1 = priority).

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)