Skip to main content
POST
/
userPosition
Create a user position
curl --request POST \
  --url https://api.projectcor.com/v1/userPosition \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "C",
  "rate": 123,
  "seniority": "<string>",
  "user_position_category_id": 123,
  "segmentLabel": "<string>"
}
'
{
  "id": 123,
  "name": "<string>",
  "user_position_category_id": 123,
  "type": "C",
  "rate": 123,
  "seniority": "<string>",
  "company_id": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

Position name. Must be unique within the company and pass validation rules.

​
type
enum<string>
required

Type of position: 'C' for category, 'P' for position

Available options:
C,
P
​
rate
number

Base rate for the position

​
seniority
string | null

Seniority level of the position

​
user_position_category_id
integer | null

ID of the parent category (only for positions, not categories). This field is required if you need to see positions in capacity planning and positions list

​
segmentLabel
string | null

Segment label used to group positions. Required only if company has feature flag to manage positions by labels enabled. Ignored if feature flag is not enabled.

Response

User position created successfully

​
id
integer
​
name
string
​
user_position_category_id
number
​
type
enum<string>

Type of position: 'C' for category, 'P' for position

Available options:
C,
P
​
rate
integer
​
seniority
string
​
company_id
integer