Clone a Position

Clone a Position from a position template.

📘

Position and opening(s)

When making a request to clone a position, you can also define the details for the opening(s) that will be created for the new position. The openings array is optional - if you don't provide any opening details, a single new opening will be created by default.

Request

POST https://api.comeet.co/positions/{uid}/clone

Request path parameters:

NameTypeOptionalDescription
uidstringRequiredPosition UID - only positions with "is_template" = true value are accepted.

Request body parameters:

Field

Type

Required

Description

name

string

required

copy_assignees

boolean

required

When true - The position workflow will be created with the same assignees and hiring team as the template position.
When false- The new hiring team will assign the position workflow.

status

string

required

One of the following:
open
on hold
closed

is_discreet

boolean

required

true means that the position is only visible to teammates on the position's hiring team.

department

string

optional

If the provided value doesn't exist, it will be added as a new option

experience_level

string

optional

If the provided value doesn't exist, it will be added as a new option

employment_type

string

optional

If the provided value doesn't exist, it will be added as a new option

is_talent_pool

boolean

optional

true means that this position is a talent pool

location

object

optional

location.uid

string

optional

Location UID

salary_range

object

Position salary range. Permission to write positions salary range is required.

salary_range.min

int

salary_range.max

int

salary_range.currency_code

string

Currency using 3 letters code (ISO 4217)

salary_range.period

string

One of the following:
hourly
weekly
monthly
annually

categories

array

optional

Custom categories

categories[].name

string

required for provided categories

Must match an existing field's name

categories[].value

string

required for provided categories

For dropdown fields - a value that doesn't already exist will be added as a dropdown option

details

array

optional

Free-form text details.

details[].name

string

required for provided details

Must match an existing field's name

details[].value

string

required for provided details

HTML

allow_fallback

boolean

optional

Applies when the email provided for users doesn't match an existing user in Recruit:
When true - the earliest Owner of the account is assigned for the role instead of the specified user.
When false(default) - the request will fail

users

object

required

users.lead_recruiter

object

required

users.lead_recruiter.email

string

required

Email address of an existing user. Must have a company recruiter role.

users.hiring_manager

object

required

users.hiring_manager.email

string

required

Email address of an existing user

users.lead_recruiting_coordinator

object

optional

users.lead_recruiting_coordinator.email

string

optional

Email address of an existing user

openings[]

array

optional

openings[].name

string

required

Opening name

openings[].approval_status

string

optional

One of the following:
APPROVED

openings[].time_expected_hire

date

required

openings[].reason

string

required

One of the following:
New,
Replacement hire,
Temporary replacement

openings[].status

string

required

Must be OPEN

openings[].time_approved

date

optional

Required if the approval status is set to APPROVED

openings[].time_opened

date

optional

If empty, the default value is the time of the creation of the opening.

openings[].custom_fields

object

optional

Key-value pairs of custom opening fields.
Keys must match a name of an existing custom field.
For dropdown fields - a value that doesn't already exist will be added as a dropdown option.

questionnaire_uids

array

optional

questionnaires UIDs

{  
  "name":"Account Executive, Austin",
  "status": "open",
  "is_discreet": false,
 	"copy_assignees": false,
  "department":"Sales",
  "employment_type":"Full-time",
  "experience_level":"Intermediate",
  "is_talent_pool": false,          
  "location_uid": "D00.000",
   "salary_range": {
   	"min": 200000,
   	"max": 40000,
   	"currency_code": "USD",
   	"period": "Monthly"
  },
  "questionnaire_uids": ['00.001','00.002','00.003'],
  "categories":[  
    {  
      "name":"Territory",
      "value":"USA"
    },
    {
      "name": "workplace_type",
      "value": "Remote"
    }
    //...
  ],
  "details":[  
    {  
      "name":"Description",
      "value":"We are looking for ..."
    },
    {  
      "name":"Requirements",
      "value":"Candidates should have ..."
    }
    //...
  ],
  "users": {
    "hiring_manager": {
      "email": "[email protected]"
    },
    "lead_recruiter": {
      "email": "[email protected]"
    }
  },
  "openings": [
    {
      "name": "Opening 1",
      "time_expected_hire": "2023-09-17T13:10:59Z",
      "reason": "New",
      "status": "Open",
      "time_opened": "2023-07-19T13:10:59Z"
    },
    {
      "name": "Opening 2",
      "time_approved": "2023-07-01",
      "time_expected_hire": "2023-09-17T13:10:59Z",
      "reason": "New",
      "status": "Open",
      "time_opened": "2023-07-19T13:10:59Z"
    }
  ]
}

Response

Fields that are set to "Internal use" will be omitted from the response.

{  
  "uid":"87.405",
  "name":"Account Executive, Austin",
  "status": "open",
  "is_discreet": false,
  "is_published": true,    
  "department":"Sales",
  "email":"[email protected]",
  "url_recruit_hosted_page":"https://www.comeet.co/jobs/companyname/30.005/account-executive-austin/87.405",
  "url_active_page":"https://www.comeet.co/jobs/companyname/30.005/account-executive-austin/87.405",
  "employment_type":"Full-time",
  "experience_level":"Intermediate",
  "internal_use_custom_id":null,
  "picture_url":"https://comeet-euw-app.s3.amazonaws.com/53/b5ac4af700dfe6d749a862f7ba267f288f6cb575",
  "time_updated":"2017-05-26T14:22:46Z",
  "company_name":"Company Name",
  "position_url":"https://www.comeet.co/careers-api/2.0/company/30.005/positions/87.405?token=359F1DD13E1DD1DD1A813E6A6A",
  "is_talent_pool": false,          
  "location":{  
    "name":"Austin, TX",
    "country":"US",
    "city":"Austin",
    "state":"TX",
    "postal_code":"",
    "street_name":"",
    "arrival_instructions":null,
    "street_number":"",
    "timezone":"America/Iqaluit",
    "uid": "D00.000"
  },
   "salary_range": {
   	"min": 200000,
   	"max": 40000,
   	"currency_code": "USD",
   	"period": "Monthly"
  },
  "categories":[  
    {  
      "name":"Territory",
      "value":"USA",
      "order":1
    },
    {
      "name": "workplace_type",
      "value": "Remote",
      "order":2
    }
    //...
  ],
  "details":[  
    {  
      "name":"Description",
      "value":"We are looking for ...",
      "order":1
    },
    {  
      "name":"Requirements",
      "value":"Candidates should have ...",
      "order":2
    }
    //...
  ],
"openings": [
        {
            "uid": "D0.000",
            "name": "Opening 1",
            "approval_process": null,
            "hired_candidate_uid": null,
            "time_expected_hire": "2023-09-17T13:10:59Z",
            "headcount": 1,
            "reason": "New",
            "status": "Open",
            "time_created": "2023-09-20T22:05:40Z",
            "time_last_status_change": "2023-09-20T22:05:40Z",
            "time_opened": "2023-07-19T13:10:59Z",
            "time_updated": "2023-09-20T22:05:40Z",
            "custom_fields": {}
        },
        {
            "uid": "D0.001",
            "name": "Opening 2",
            "approval_process": null,
            "hired_candidate_uid": null,
            "time_expected_hire": "2023-09-17T13:10:59Z",
            "headcount": 1,
            "reason": "New",
            "status": "Open",
            "time_created": "2023-09-20T22:05:40Z",
            "time_last_status_change": "2023-09-20T22:05:40Z",
            "time_opened": "2023-07-19T13:10:59Z",
            "time_updated": "2023-09-20T22:05:40Z",
            "custom_fields": {}
        }  
}