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:
Name | Type | Optional | Description |
---|---|---|---|
uid | string | Required | Position 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 Comeet: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_comeet_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": {}
}
}