Create multiple identical positions with employee assignment

post

https://api.gupy.io/os/v1/positions/replication/with-employees

Creates multiple identical positions and assigns each one to a specific employee. All positions will have the same base data (role, area, etc.) but each will be linked to a different employee. Provide either an array of employee emails or taxpayer registries (CPF), but not both. Maximum 10 employees per request. External codes are auto-generated for each position.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Batch position creation data

name

string

required

length ≤ 255

Human-readable name for the position

externalCodeRole

string

required

length ≤ 50

External code of the role to associate with this position

externalCodeArea

string

required

length ≤ 50

External code of the area to associate with this position

description

string | null

Optional detailed description of the position responsibilities and requirements

externalCodeCostCenter

string

length ≤ 50

Optional external code of the cost center to associate with this position

externalCodeParent

string

required

length ≤ 50

External code of the parent position in the organizational hierarchy (required)

externalCodeOperationUnit

string

length ≤ 50

Optional external code of the operation unit to associate with this position

employeeEmails

array of strings

length between 1 and 10

Array of employee emails to create positions for. Must provide either employeeEmails or employeeTaxpayerRegistries, but not both. Maximum 10 items.

employeeEmails

employeeTaxpayerRegistries

array of strings

length between 1 and 10

Array of employee taxpayer registries (CPF) to create positions for. Must provide either employeeEmails or employeeTaxpayerRegistries, but not both. Maximum 10 items.

employeeTaxpayerRegistries

Responses

400

Bad request - validation errors (e.g., both arrays provided, no employees found, more than 10 items)

404

None of the provided employees were found

422

Validation error - missing required fields or invalid relationships

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201All positions were created successfully. Returns array of created positions.

207Partial success - some positions were created, some failed. Returns created positions and errors for failed identifiers.