---
title: "Create a new position replication"
method: POST
path: "/os/v1/positions/replication"
tags: ["Position"]
---

# Create a new position replication

`POST /os/v1/positions/replication`

Creates a series of new replicas of a new position using the provided data.

## Query parameters

- `quantity` number

## Request body

- CreatePositionReplicationsInput
  - `name` string, required — Position name
  - `externalCodeRole` string, required — Role external code
  - `externalCodeArea` string, required — Area external code
  - `description` string — Position description
  - `externalCodeCostCenter` string — Cost center external code
  - `externalCodeOperationUnit` string — Operation unit external code
  - `externalCodeParent` string, required — Parent position external code

## Response `201`

- PositionOutput[]
  - `uuid` string, uuid, required — Position UUID
  - `name` string, required — Position name
  - `externalCode` string, required — Position external code
  - `description` string, nullable — Position description
  - `role` PositionRoleOutput, required
    - `uuid` string, uuid, required — role UUID
    - `name` string, required — role name
    - `similarity` 'AUXILIARY' | 'CONSULTANT' | 'SUPERVISOR' | 'DEVELOPER' | 'DIRECTOR' | 'INTERNSHIP' | 'SPECIALIST' | 'MANAGER' | 'OPERATOR' | 'TECHNICAL' | 'TRAINEE' | 'COORDINATOR' | 'ANALYST' | 'APPRENTICE' | 'COORDINATOR_OR_SUPERVISOR' | 'ANALYST_OR_AUXILIARY' | 'EXECUTIVE', required — role similarity
    - `externalCode` string, required — role external code
  - `employee` PositionEmployeeOutput
    - `uuid` string, required — employee UUID
    - `internalCompanyNumber` string, required — Internal company number (registration)
  - `area` PositionAreaOutput, required
    - `uuid` string, required — area UUID
    - `name` string, required — area name
    - `similarity` 'ADMINISTRATIVE' | 'FINANCIAL' | 'AGRONOMY' | 'ARCHITECTURE' | 'AUDITING' | 'QUALITY' | 'CUSTOMER_SERVICE' | 'COMMERCIAL' | 'PURCHASING' | 'COMMUNICATION' | 'DESIGN' | 'MARKETING' | 'ACCOUNTING' | 'CONTROLLING' | 'ENGINEERING' | 'MAINTENANCE' | 'TECHNICAL_SERVICES' | 'LEGAL' | 'INNOVATION' | 'PRODUCT' | 'LOGISTICS' | 'OPERATION' | 'PROJECTS' | 'PROCESSES' | 'HUMAN_RESOURCES' | 'SECURITY' | 'TECHNOLOGY', required — area similarity
    - `externalCode` string, required — area codigo externo
  - `costCenter` PositionCostCenterOutput
    - `uuid` string, uuid, required — cost center UUID
    - `name` string, required — cost center name
    - `externalCode` string, required — cost center external code
  - `operationUnit` PositionOperationUnitOutput
    - `uuid` string, uuid, required — operation unit UUID
    - `name` string, required — operation unit name
    - `externalCode` string, required — operation unit external code
  - `parent` ParentPositionOutput
    - `uuid` string, uuid, required — Position UUID
    - `name` string, required — Position name
    - `externalCode` string, required — Position external code
    - `employee` PositionEmployeeOutput
      - `uuid` string, required — employee UUID
      - `internalCompanyNumber` string, required — Internal company number (registration)
  - `additionalParents` ParentPositionOutput[] — Additional parent positions (additional leadership)
    - `uuid` string, uuid, required — Position UUID
    - `name` string, required — Position name
    - `externalCode` string, required — Position external code
    - `employee` PositionEmployeeOutput
      - `uuid` string, required — employee UUID
      - `internalCompanyNumber` string, required — Internal company number (registration)
  - `status` 'OPEN' | 'FILLED' | 'CLOSED' | 'FROZEN', required — Position status indicating current state (OPEN: available for assignment, FILLED: has assigned employee, CLOSED: no longer active, FROZEN: temporarily inactive)

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/versions/3f26defa2a42/schema)