v1

latestOpenAPI 3.0.12026-07-24283883639.5 KB

Job Roles

Create a New Job Role

This endpoint creates a new job role. <h3>Required Scope</h3>job_roles:write

post/api/v2/job-roles

Request body

Example request

{
  "data": {
    "type": "job-roles",
    "attributes": {
      "role-id": "RoleID123",
      "name": "Product Manager",
      "description": "Product Manager role",
      "data": [
        {
          "type": "skills",
          "id": "programming",
          "meta": {
            "target-level": 4,
            "priority": 1
          }
        }
      ]
    }
  }
}

Response

Success

Example response

{
  "data": {
    "type": "job-roles",
    "id": "roleId123",
    "attributes": {
      "role-id": "RoleID123",
      "name": "Product Manager",
      "description": "Product Manager role",
      "data": [
        {
          "type": "skills",
          "id": "Product Management",
          "meta": {
            "target-level": 4
          }
        }
      ]
    }
  }
}