Change the settings of a position step
curl --request POST \
--url https://cool.jobmojito.com/functions/v1/merchant-position-step-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"step_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"expected_updated_at": "2023-11-07T05:31:56Z",
"dry_run": false,
"kombo": {
"accept_stage_id": "<string>",
"reject_reason_id": "<string>",
"reject_reason_ai_id": "<string>"
},
"meeting": {
"duration_minutes": 722,
"location": "<string>",
"meeting_url": "<string>",
"instructions": "<string>",
"reschedule_cutoff_hours": 4380,
"nudge_after_days": 182,
"interviewer_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"panel_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"slot_interval_minutes": 122,
"min_notice_hours": 360,
"horizon_days": 183,
"data_collection": {
"taxonomy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"email_variant": "<string>"
},
"certo": {
"wait_for_identity": true,
"include_contact": true,
"scope_types": []
},
"external_assessment": {
"provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"instructions": "<string>",
"due_days": 30,
"pass_score": 123
},
"interview": {
"allow_human_interview": true
},
"pre_screening": {
"form_fields": [
{
"id": "<string>"
}
],
"assessment_rules": [
{
"id": "<string>"
}
],
"position_country": "<string>",
"candidate_expectations": "<string>",
"all_rules_fulfilled_auto_approve": true,
"id": "<string>",
"status": "<string>"
}
}
'import requests
url = "https://cool.jobmojito.com/functions/v1/merchant-position-step-update"
payload = {
"step_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"expected_updated_at": "2023-11-07T05:31:56Z",
"dry_run": False,
"kombo": {
"accept_stage_id": "<string>",
"reject_reason_id": "<string>",
"reject_reason_ai_id": "<string>"
},
"meeting": {
"duration_minutes": 722,
"location": "<string>",
"meeting_url": "<string>",
"instructions": "<string>",
"reschedule_cutoff_hours": 4380,
"nudge_after_days": 182,
"interviewer_profile_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"panel_profile_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"slot_interval_minutes": 122,
"min_notice_hours": 360,
"horizon_days": 183,
"data_collection": { "taxonomy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" },
"email_variant": "<string>"
},
"certo": {
"wait_for_identity": True,
"include_contact": True,
"scope_types": []
},
"external_assessment": {
"provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"instructions": "<string>",
"due_days": 30,
"pass_score": 123
},
"interview": { "allow_human_interview": True },
"pre_screening": {
"form_fields": [{ "id": "<string>" }],
"assessment_rules": [{ "id": "<string>" }],
"position_country": "<string>",
"candidate_expectations": "<string>",
"all_rules_fulfilled_auto_approve": True,
"id": "<string>",
"status": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
step_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
expected_updated_at: '2023-11-07T05:31:56Z',
dry_run: false,
kombo: {
accept_stage_id: '<string>',
reject_reason_id: '<string>',
reject_reason_ai_id: '<string>'
},
meeting: {
duration_minutes: 722,
location: '<string>',
meeting_url: '<string>',
instructions: '<string>',
reschedule_cutoff_hours: 4380,
nudge_after_days: 182,
interviewer_profile_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
panel_profile_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
slot_interval_minutes: 122,
min_notice_hours: 360,
horizon_days: 183,
data_collection: {taxonomy_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
email_variant: '<string>'
},
certo: {wait_for_identity: true, include_contact: true, scope_types: []},
external_assessment: {
provider_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
instructions: '<string>',
due_days: 30,
pass_score: 123
},
interview: {allow_human_interview: true},
pre_screening: {
form_fields: [{id: '<string>'}],
assessment_rules: [{id: '<string>'}],
position_country: '<string>',
candidate_expectations: '<string>',
all_rules_fulfilled_auto_approve: true,
id: '<string>',
status: '<string>'
}
})
};
fetch('https://cool.jobmojito.com/functions/v1/merchant-position-step-update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://cool.jobmojito.com/functions/v1/merchant-position-step-update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'step_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'expected_updated_at' => '2023-11-07T05:31:56Z',
'dry_run' => false,
'kombo' => [
'accept_stage_id' => '<string>',
'reject_reason_id' => '<string>',
'reject_reason_ai_id' => '<string>'
],
'meeting' => [
'duration_minutes' => 722,
'location' => '<string>',
'meeting_url' => '<string>',
'instructions' => '<string>',
'reschedule_cutoff_hours' => 4380,
'nudge_after_days' => 182,
'interviewer_profile_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'panel_profile_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'slot_interval_minutes' => 122,
'min_notice_hours' => 360,
'horizon_days' => 183,
'data_collection' => [
'taxonomy_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'email_variant' => '<string>'
],
'certo' => [
'wait_for_identity' => true,
'include_contact' => true,
'scope_types' => [
]
],
'external_assessment' => [
'provider_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'instructions' => '<string>',
'due_days' => 30,
'pass_score' => 123
],
'interview' => [
'allow_human_interview' => true
],
'pre_screening' => [
'form_fields' => [
[
'id' => '<string>'
]
],
'assessment_rules' => [
[
'id' => '<string>'
]
],
'position_country' => '<string>',
'candidate_expectations' => '<string>',
'all_rules_fulfilled_auto_approve' => true,
'id' => '<string>',
'status' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://cool.jobmojito.com/functions/v1/merchant-position-step-update"
payload := strings.NewReader("{\n \"step_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"expected_updated_at\": \"2023-11-07T05:31:56Z\",\n \"dry_run\": false,\n \"kombo\": {\n \"accept_stage_id\": \"<string>\",\n \"reject_reason_id\": \"<string>\",\n \"reject_reason_ai_id\": \"<string>\"\n },\n \"meeting\": {\n \"duration_minutes\": 722,\n \"location\": \"<string>\",\n \"meeting_url\": \"<string>\",\n \"instructions\": \"<string>\",\n \"reschedule_cutoff_hours\": 4380,\n \"nudge_after_days\": 182,\n \"interviewer_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"panel_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"slot_interval_minutes\": 122,\n \"min_notice_hours\": 360,\n \"horizon_days\": 183,\n \"data_collection\": {\n \"taxonomy_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"email_variant\": \"<string>\"\n },\n \"certo\": {\n \"wait_for_identity\": true,\n \"include_contact\": true,\n \"scope_types\": []\n },\n \"external_assessment\": {\n \"provider_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"instructions\": \"<string>\",\n \"due_days\": 30,\n \"pass_score\": 123\n },\n \"interview\": {\n \"allow_human_interview\": true\n },\n \"pre_screening\": {\n \"form_fields\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"assessment_rules\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"position_country\": \"<string>\",\n \"candidate_expectations\": \"<string>\",\n \"all_rules_fulfilled_auto_approve\": true,\n \"id\": \"<string>\",\n \"status\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://cool.jobmojito.com/functions/v1/merchant-position-step-update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"step_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"expected_updated_at\": \"2023-11-07T05:31:56Z\",\n \"dry_run\": false,\n \"kombo\": {\n \"accept_stage_id\": \"<string>\",\n \"reject_reason_id\": \"<string>\",\n \"reject_reason_ai_id\": \"<string>\"\n },\n \"meeting\": {\n \"duration_minutes\": 722,\n \"location\": \"<string>\",\n \"meeting_url\": \"<string>\",\n \"instructions\": \"<string>\",\n \"reschedule_cutoff_hours\": 4380,\n \"nudge_after_days\": 182,\n \"interviewer_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"panel_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"slot_interval_minutes\": 122,\n \"min_notice_hours\": 360,\n \"horizon_days\": 183,\n \"data_collection\": {\n \"taxonomy_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"email_variant\": \"<string>\"\n },\n \"certo\": {\n \"wait_for_identity\": true,\n \"include_contact\": true,\n \"scope_types\": []\n },\n \"external_assessment\": {\n \"provider_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"instructions\": \"<string>\",\n \"due_days\": 30,\n \"pass_score\": 123\n },\n \"interview\": {\n \"allow_human_interview\": true\n },\n \"pre_screening\": {\n \"form_fields\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"assessment_rules\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"position_country\": \"<string>\",\n \"candidate_expectations\": \"<string>\",\n \"all_rules_fulfilled_auto_approve\": true,\n \"id\": \"<string>\",\n \"status\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://cool.jobmojito.com/functions/v1/merchant-position-step-update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"step_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"expected_updated_at\": \"2023-11-07T05:31:56Z\",\n \"dry_run\": false,\n \"kombo\": {\n \"accept_stage_id\": \"<string>\",\n \"reject_reason_id\": \"<string>\",\n \"reject_reason_ai_id\": \"<string>\"\n },\n \"meeting\": {\n \"duration_minutes\": 722,\n \"location\": \"<string>\",\n \"meeting_url\": \"<string>\",\n \"instructions\": \"<string>\",\n \"reschedule_cutoff_hours\": 4380,\n \"nudge_after_days\": 182,\n \"interviewer_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"panel_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"slot_interval_minutes\": 122,\n \"min_notice_hours\": 360,\n \"horizon_days\": 183,\n \"data_collection\": {\n \"taxonomy_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"email_variant\": \"<string>\"\n },\n \"certo\": {\n \"wait_for_identity\": true,\n \"include_contact\": true,\n \"scope_types\": []\n },\n \"external_assessment\": {\n \"provider_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"instructions\": \"<string>\",\n \"due_days\": 30,\n \"pass_score\": 123\n },\n \"interview\": {\n \"allow_human_interview\": true\n },\n \"pre_screening\": {\n \"form_fields\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"assessment_rules\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"position_country\": \"<string>\",\n \"candidate_expectations\": \"<string>\",\n \"all_rules_fulfilled_auto_approve\": true,\n \"id\": \"<string>\",\n \"status\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"step": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "pre-screening",
"name": "<string>",
"position_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequence_no": 123,
"updated_at": "<string>",
"advance": "auto",
"interview_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"interview_pre_screening_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kombo": {
"accept_stage_id": "<string>",
"reject_reason_id": "<string>",
"reject_reason_ai_id": "<string>"
},
"meeting": {
"mode": "slots",
"duration_minutes": 722,
"location": "<string>",
"conference_provider": "in_person",
"meeting_url": "<string>",
"instructions": "<string>",
"reschedule_cutoff_hours": 4380,
"nudge_after_days": 182,
"interviewer_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"panel_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"slot_interval_minutes": 122,
"min_notice_hours": 360,
"horizon_days": 183,
"data_collection": {
"mode": "none",
"taxonomy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"email_variant": "<string>"
},
"certo": {
"wait_for_identity": true,
"include_contact": true,
"scope_types": [
"employment"
]
},
"external_assessment": {
"provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"instructions": "<string>",
"due_days": 30,
"pass_score": 123
},
"interview": {
"allow_human_interview": true
},
"pre_screening": {
"type": "resume",
"form_fields": [
{
"id": "<string>"
}
],
"assessment_rules": [
{
"id": "<string>"
}
],
"position_country": "<string>",
"candidate_expectations": "<string>",
"all_rules_fulfilled_auto_approve": true
}
},
"changed_keys": [
"<string>"
],
"candidates_on_step": 123,
"booked_meetings": 123,
"warnings": [
"<string>"
],
"dry_run": true
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}Positions
Change the settings of a position step
Changes the name and settings of one step of a position: advance and kombo on every step, plus the one settings object of the step’s type (meeting, certo, external_assessment, interview or pre_screening; another type’s object is a 422). Only the keys sent change: nested keys are merged one by one, null removes a key. Works on published positions too (the structure is changed with set_position_process, drafts only). Settings are read live, so candidates already on the step get the new settings at once; nobody is e-mailed by this call. Use dry_run to see changed_keys, candidates_on_step, booked_meetings and warnings first, and expected_updated_at to refuse a stale change. Owners and recruiters on the position’s access list; hiring managers read only.
POST
/
merchant-position-step-update
Change the settings of a position step
curl --request POST \
--url https://cool.jobmojito.com/functions/v1/merchant-position-step-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"step_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"expected_updated_at": "2023-11-07T05:31:56Z",
"dry_run": false,
"kombo": {
"accept_stage_id": "<string>",
"reject_reason_id": "<string>",
"reject_reason_ai_id": "<string>"
},
"meeting": {
"duration_minutes": 722,
"location": "<string>",
"meeting_url": "<string>",
"instructions": "<string>",
"reschedule_cutoff_hours": 4380,
"nudge_after_days": 182,
"interviewer_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"panel_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"slot_interval_minutes": 122,
"min_notice_hours": 360,
"horizon_days": 183,
"data_collection": {
"taxonomy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"email_variant": "<string>"
},
"certo": {
"wait_for_identity": true,
"include_contact": true,
"scope_types": []
},
"external_assessment": {
"provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"instructions": "<string>",
"due_days": 30,
"pass_score": 123
},
"interview": {
"allow_human_interview": true
},
"pre_screening": {
"form_fields": [
{
"id": "<string>"
}
],
"assessment_rules": [
{
"id": "<string>"
}
],
"position_country": "<string>",
"candidate_expectations": "<string>",
"all_rules_fulfilled_auto_approve": true,
"id": "<string>",
"status": "<string>"
}
}
'import requests
url = "https://cool.jobmojito.com/functions/v1/merchant-position-step-update"
payload = {
"step_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"expected_updated_at": "2023-11-07T05:31:56Z",
"dry_run": False,
"kombo": {
"accept_stage_id": "<string>",
"reject_reason_id": "<string>",
"reject_reason_ai_id": "<string>"
},
"meeting": {
"duration_minutes": 722,
"location": "<string>",
"meeting_url": "<string>",
"instructions": "<string>",
"reschedule_cutoff_hours": 4380,
"nudge_after_days": 182,
"interviewer_profile_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"panel_profile_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"slot_interval_minutes": 122,
"min_notice_hours": 360,
"horizon_days": 183,
"data_collection": { "taxonomy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" },
"email_variant": "<string>"
},
"certo": {
"wait_for_identity": True,
"include_contact": True,
"scope_types": []
},
"external_assessment": {
"provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"instructions": "<string>",
"due_days": 30,
"pass_score": 123
},
"interview": { "allow_human_interview": True },
"pre_screening": {
"form_fields": [{ "id": "<string>" }],
"assessment_rules": [{ "id": "<string>" }],
"position_country": "<string>",
"candidate_expectations": "<string>",
"all_rules_fulfilled_auto_approve": True,
"id": "<string>",
"status": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
step_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
expected_updated_at: '2023-11-07T05:31:56Z',
dry_run: false,
kombo: {
accept_stage_id: '<string>',
reject_reason_id: '<string>',
reject_reason_ai_id: '<string>'
},
meeting: {
duration_minutes: 722,
location: '<string>',
meeting_url: '<string>',
instructions: '<string>',
reschedule_cutoff_hours: 4380,
nudge_after_days: 182,
interviewer_profile_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
panel_profile_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
slot_interval_minutes: 122,
min_notice_hours: 360,
horizon_days: 183,
data_collection: {taxonomy_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
email_variant: '<string>'
},
certo: {wait_for_identity: true, include_contact: true, scope_types: []},
external_assessment: {
provider_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
instructions: '<string>',
due_days: 30,
pass_score: 123
},
interview: {allow_human_interview: true},
pre_screening: {
form_fields: [{id: '<string>'}],
assessment_rules: [{id: '<string>'}],
position_country: '<string>',
candidate_expectations: '<string>',
all_rules_fulfilled_auto_approve: true,
id: '<string>',
status: '<string>'
}
})
};
fetch('https://cool.jobmojito.com/functions/v1/merchant-position-step-update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://cool.jobmojito.com/functions/v1/merchant-position-step-update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'step_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'expected_updated_at' => '2023-11-07T05:31:56Z',
'dry_run' => false,
'kombo' => [
'accept_stage_id' => '<string>',
'reject_reason_id' => '<string>',
'reject_reason_ai_id' => '<string>'
],
'meeting' => [
'duration_minutes' => 722,
'location' => '<string>',
'meeting_url' => '<string>',
'instructions' => '<string>',
'reschedule_cutoff_hours' => 4380,
'nudge_after_days' => 182,
'interviewer_profile_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'panel_profile_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'slot_interval_minutes' => 122,
'min_notice_hours' => 360,
'horizon_days' => 183,
'data_collection' => [
'taxonomy_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'email_variant' => '<string>'
],
'certo' => [
'wait_for_identity' => true,
'include_contact' => true,
'scope_types' => [
]
],
'external_assessment' => [
'provider_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'instructions' => '<string>',
'due_days' => 30,
'pass_score' => 123
],
'interview' => [
'allow_human_interview' => true
],
'pre_screening' => [
'form_fields' => [
[
'id' => '<string>'
]
],
'assessment_rules' => [
[
'id' => '<string>'
]
],
'position_country' => '<string>',
'candidate_expectations' => '<string>',
'all_rules_fulfilled_auto_approve' => true,
'id' => '<string>',
'status' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://cool.jobmojito.com/functions/v1/merchant-position-step-update"
payload := strings.NewReader("{\n \"step_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"expected_updated_at\": \"2023-11-07T05:31:56Z\",\n \"dry_run\": false,\n \"kombo\": {\n \"accept_stage_id\": \"<string>\",\n \"reject_reason_id\": \"<string>\",\n \"reject_reason_ai_id\": \"<string>\"\n },\n \"meeting\": {\n \"duration_minutes\": 722,\n \"location\": \"<string>\",\n \"meeting_url\": \"<string>\",\n \"instructions\": \"<string>\",\n \"reschedule_cutoff_hours\": 4380,\n \"nudge_after_days\": 182,\n \"interviewer_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"panel_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"slot_interval_minutes\": 122,\n \"min_notice_hours\": 360,\n \"horizon_days\": 183,\n \"data_collection\": {\n \"taxonomy_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"email_variant\": \"<string>\"\n },\n \"certo\": {\n \"wait_for_identity\": true,\n \"include_contact\": true,\n \"scope_types\": []\n },\n \"external_assessment\": {\n \"provider_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"instructions\": \"<string>\",\n \"due_days\": 30,\n \"pass_score\": 123\n },\n \"interview\": {\n \"allow_human_interview\": true\n },\n \"pre_screening\": {\n \"form_fields\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"assessment_rules\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"position_country\": \"<string>\",\n \"candidate_expectations\": \"<string>\",\n \"all_rules_fulfilled_auto_approve\": true,\n \"id\": \"<string>\",\n \"status\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://cool.jobmojito.com/functions/v1/merchant-position-step-update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"step_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"expected_updated_at\": \"2023-11-07T05:31:56Z\",\n \"dry_run\": false,\n \"kombo\": {\n \"accept_stage_id\": \"<string>\",\n \"reject_reason_id\": \"<string>\",\n \"reject_reason_ai_id\": \"<string>\"\n },\n \"meeting\": {\n \"duration_minutes\": 722,\n \"location\": \"<string>\",\n \"meeting_url\": \"<string>\",\n \"instructions\": \"<string>\",\n \"reschedule_cutoff_hours\": 4380,\n \"nudge_after_days\": 182,\n \"interviewer_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"panel_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"slot_interval_minutes\": 122,\n \"min_notice_hours\": 360,\n \"horizon_days\": 183,\n \"data_collection\": {\n \"taxonomy_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"email_variant\": \"<string>\"\n },\n \"certo\": {\n \"wait_for_identity\": true,\n \"include_contact\": true,\n \"scope_types\": []\n },\n \"external_assessment\": {\n \"provider_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"instructions\": \"<string>\",\n \"due_days\": 30,\n \"pass_score\": 123\n },\n \"interview\": {\n \"allow_human_interview\": true\n },\n \"pre_screening\": {\n \"form_fields\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"assessment_rules\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"position_country\": \"<string>\",\n \"candidate_expectations\": \"<string>\",\n \"all_rules_fulfilled_auto_approve\": true,\n \"id\": \"<string>\",\n \"status\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://cool.jobmojito.com/functions/v1/merchant-position-step-update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"step_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"expected_updated_at\": \"2023-11-07T05:31:56Z\",\n \"dry_run\": false,\n \"kombo\": {\n \"accept_stage_id\": \"<string>\",\n \"reject_reason_id\": \"<string>\",\n \"reject_reason_ai_id\": \"<string>\"\n },\n \"meeting\": {\n \"duration_minutes\": 722,\n \"location\": \"<string>\",\n \"meeting_url\": \"<string>\",\n \"instructions\": \"<string>\",\n \"reschedule_cutoff_hours\": 4380,\n \"nudge_after_days\": 182,\n \"interviewer_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"panel_profile_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"slot_interval_minutes\": 122,\n \"min_notice_hours\": 360,\n \"horizon_days\": 183,\n \"data_collection\": {\n \"taxonomy_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n },\n \"email_variant\": \"<string>\"\n },\n \"certo\": {\n \"wait_for_identity\": true,\n \"include_contact\": true,\n \"scope_types\": []\n },\n \"external_assessment\": {\n \"provider_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"instructions\": \"<string>\",\n \"due_days\": 30,\n \"pass_score\": 123\n },\n \"interview\": {\n \"allow_human_interview\": true\n },\n \"pre_screening\": {\n \"form_fields\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"assessment_rules\": [\n {\n \"id\": \"<string>\"\n }\n ],\n \"position_country\": \"<string>\",\n \"candidate_expectations\": \"<string>\",\n \"all_rules_fulfilled_auto_approve\": true,\n \"id\": \"<string>\",\n \"status\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"step": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "pre-screening",
"name": "<string>",
"position_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequence_no": 123,
"updated_at": "<string>",
"advance": "auto",
"interview_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"interview_pre_screening_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kombo": {
"accept_stage_id": "<string>",
"reject_reason_id": "<string>",
"reject_reason_ai_id": "<string>"
},
"meeting": {
"mode": "slots",
"duration_minutes": 722,
"location": "<string>",
"conference_provider": "in_person",
"meeting_url": "<string>",
"instructions": "<string>",
"reschedule_cutoff_hours": 4380,
"nudge_after_days": 182,
"interviewer_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"panel_profile_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"slot_interval_minutes": 122,
"min_notice_hours": 360,
"horizon_days": 183,
"data_collection": {
"mode": "none",
"taxonomy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"email_variant": "<string>"
},
"certo": {
"wait_for_identity": true,
"include_contact": true,
"scope_types": [
"employment"
]
},
"external_assessment": {
"provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"instructions": "<string>",
"due_days": 30,
"pass_score": 123
},
"interview": {
"allow_human_interview": true
},
"pre_screening": {
"type": "resume",
"form_fields": [
{
"id": "<string>"
}
],
"assessment_rules": [
{
"id": "<string>"
}
],
"position_country": "<string>",
"candidate_expectations": "<string>",
"all_rules_fulfilled_auto_approve": true
}
},
"changed_keys": [
"<string>"
],
"candidates_on_step": 123,
"booked_meetings": 123,
"warnings": [
"<string>"
],
"dry_run": true
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}Authorizations
Supabase JWT — Authorization: Bearer <token>.
Body
application/json
The step (position_def_step.id, from get_interview_definition with include=process or set_position_process).
New name of the step. null or empty removes the name (the type's default label is shown); left out keeps it.
Maximum string length:
300The step's updated_at as you read it (get_interview_definition with include=process, or an earlier answer of this call). When the step changed since, nothing is written and the answer is 409; read it again and retry. null or left out: not checked.
true: validate and answer what would change and whom it reaches, without writing anything.
auto: a candidate who passes moves on by themselves; manual: a recruiter moves them on. null = auto.
Available options:
auto, manual Mapping of this step to the connected ATS (Kombo). Each key is merged separately.
Show child attributes
Show child attributes
Settings of a meeting step. Each key is merged separately; keys left out keep their value.
Show child attributes
Show child attributes
Settings of a certo.bio verification step.
Show child attributes
Show child attributes
Settings of an external assessment step (the external_assessment feature).
Show child attributes
Show child attributes
Settings of an AI interview step.
Show child attributes
Show child attributes
Pre-screening steps: the settings to change, as include=process returns them; that object can be sent back as it is.
Show child attributes
Show child attributes
Response
The step after the change (or as it would be, in a dry run).
A step of a position's process with its settings; only the settings object of the step's own type is present.
Show child attributes
Show child attributes
What changed (or would change in a dry run), as paths: name, advance, kombo.accept_stage_id, meeting.duration_minutes, external_assessment.due_days, scope_types, allow_human_interview, pre_screening.type, ...
Applications whose current step is this step (not withdrawn, hired or declined). Settings are read live: a change reaches them at once.
Upcoming booked meetings on this step's slots.
Things to tell the user before or after the change (who it reaches, settings that have no effect yet).
true when nothing was written.