---
title: "Create one or multiple unified jobs"
method: POST
path: "/api/servicepool/unifiedJobs"
tags: ["unifiedJobs"]
---

# Create one or multiple unified jobs

`POST /api/servicepool/unifiedJobs`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicepool/unifiedJobs`
- Auth: HTTP bearer

## Request body

- union
  - UnifiedJobsDtoInput
    - `uuid` string: The unique identifier of the unified job
    - `title` string, required: The title of the unified job
    - `description` string, required: The description of the unified job
    - `wxJobUuid` string: The unique identifier of the wx job
    - `hireJobUuid` string: The unique identifier of the position in Hire
    - `location` object
      - `uuid` string, required: The unique identifier of the location
    - `qualifications` object[]
      - `uuid` string, required: The unique identifier of the qualification
    - `demographics` object
      - `uuid` string, required: The unique identifier of the demographics
    - `onetV2Skills` object[]: List of onet v2 skills
      - `skill` string, required
      - `category` string
      - `Element ID` string
      - `frequency` number
      - `data_value` number
      - `evidence` string
    - `onetOccupation` object: Onet occupation information
      - `name` string, required
      - `onetSocCode` string, required
    - `onetV3Competencies` object[]: V3-extracted competencies in the raw writeback shape (kind, name, evidence, confidence, anchors).
      - `kind` 'task' | 'tool' | 'technology' | 'skill' | 'workContext' | 'role', required
      - `name` string, required
      - `evidence` object, required
        - `sourceField` string, required
        - `quote` string, required
      - `confidence` number, required
      - `anchors` object[]
        - `id` string, required
        - `label` string, required
        - `similarity` number, required
        - `source` string, required
  - UnifiedJobsDtoInput[]
    - `uuid` string: The unique identifier of the unified job
    - `title` string, required: The title of the unified job
    - `description` string, required: The description of the unified job
    - `wxJobUuid` string: The unique identifier of the wx job
    - `hireJobUuid` string: The unique identifier of the position in Hire
    - `location` object
      - `uuid` string, required: The unique identifier of the location
    - `qualifications` object[]
      - `uuid` string, required: The unique identifier of the qualification
    - `demographics` object
      - `uuid` string, required: The unique identifier of the demographics
    - `onetV2Skills` object[]: List of onet v2 skills
      - `skill` string, required
      - `category` string
      - `Element ID` string
      - `frequency` number
      - `data_value` number
      - `evidence` string
    - `onetOccupation` object: Onet occupation information
      - `name` string, required
      - `onetSocCode` string, required
    - `onetV3Competencies` object[]: V3-extracted competencies in the raw writeback shape (kind, name, evidence, confidence, anchors).
      - `kind` 'task' | 'tool' | 'technology' | 'skill' | 'workContext' | 'role', required
      - `name` string, required
      - `evidence` object, required
        - `sourceField` string, required
        - `quote` string, required
      - `confidence` number, required
      - `anchors` object[]
        - `id` string, required
        - `label` string, required
        - `similarity` number, required
        - `source` string, required

## Response `201`

One or many unified jobs created.

- object
  - `data` union
    - UnifiedJobsDto
      - `uuid` string, required: The unique identifier of the unified job
      - `title` string, required: The title of the unified job
      - `description` string: The description of the unified job
      - `wxJobUuid` string: The unique identifier of the wx job
      - `hireJobUuid` string: The unique identifier of the position in Hire
      - `location` object
        - `uuid` string, required: The unique identifier of the location
      - `qualifications` object[]
        - `uuid` string, required: The unique identifier of the qualification
      - `demographics` object
        - `uuid` string, required: The unique identifier of the demographics
      - `createdAt` string, date-time: The date and time the unified job was created
      - `createdBy` string: The unique identifier of the user who created the unified job
      - `updatedAt` string, date-time: The date and time the unified job was updated
      - `updatedBy` string: The unique identifier of the user who updated the unified job
      - `skills` string[]
      - `onetV2Skills` object[]: List of onet v2 skills
        - `skill` string, required
        - `category` string
        - `Element ID` string
        - `frequency` number
        - `data_value` number
        - `evidence` string
      - `onetOccupation` object: Onet occupation information
        - `name` string, required
        - `onetSocCode` string, required
      - `onetV3Competencies` object[]: V3-extracted competencies in the raw writeback shape (kind, name, evidence, confidence, anchors).
        - `kind` 'task' | 'tool' | 'technology' | 'skill' | 'workContext' | 'role', required
        - `name` string, required
        - `evidence` object, required
          - `sourceField` string, required
          - `quote` string, required
        - `confidence` number, required
        - `anchors` object[]
          - `id` string, required
          - `label` string, required
          - `similarity` number, required
          - `source` string, required
    - UnifiedJobsDto[]
      - `uuid` string, required: The unique identifier of the unified job
      - `title` string, required: The title of the unified job
      - `description` string: The description of the unified job
      - `wxJobUuid` string: The unique identifier of the wx job
      - `hireJobUuid` string: The unique identifier of the position in Hire
      - `location` object
        - `uuid` string, required: The unique identifier of the location
      - `qualifications` object[]
        - `uuid` string, required: The unique identifier of the qualification
      - `demographics` object
        - `uuid` string, required: The unique identifier of the demographics
      - `createdAt` string, date-time: The date and time the unified job was created
      - `createdBy` string: The unique identifier of the user who created the unified job
      - `updatedAt` string, date-time: The date and time the unified job was updated
      - `updatedBy` string: The unique identifier of the user who updated the unified job
      - `skills` string[]
      - `onetV2Skills` object[]: List of onet v2 skills
        - `skill` string, required
        - `category` string
        - `Element ID` string
        - `frequency` number
        - `data_value` number
        - `evidence` string
      - `onetOccupation` object: Onet occupation information
        - `name` string, required
        - `onetSocCode` string, required
      - `onetV3Competencies` object[]: V3-extracted competencies in the raw writeback shape (kind, name, evidence, confidence, anchors).
        - `kind` 'task' | 'tool' | 'technology' | 'skill' | 'workContext' | 'role', required
        - `name` string, required
        - `evidence` object, required
          - `sourceField` string, required
          - `quote` string, required
        - `confidence` number, required
        - `anchors` object[]
          - `id` string, required
          - `label` string, required
          - `similarity` number, required
          - `source` string, required
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `409`: default error response
- `500`: default error response

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)