Move application to stage

TypeScript

import { Kombo } from "@kombo-api/sdk";

const kombo = new Kombo({
  integration_id: "workday:HWUTwvyx2wLoSUHphiWVrp28",
  api_key: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await kombo.ats.moveApplicationToStage({
    application_id: "GRKdd9dibYKKCrmGRSMJf3wu",
    body: {
      stage_id: "3PJ8PZhZZa1eEdd2DtPNtVup",
    },
  });

  console.log(result);
}

run();

require 'kombo'

Models = ::Kombo::Models
s = ::Kombo::Kombo.new(
  integration_id: 'workday:HWUTwvyx2wLoSUHphiWVrp28',
  security: Models::Shared::Security.new(
    api_key: '<YOUR_BEARER_TOKEN_HERE>'
  )
)
res = s.ats.move_application_to_stage(application_id: 'GRKdd9dibYKKCrmGRSMJf3wu', body: Models::Shared::PutAtsApplicationsApplicationIdStageRequestBody.new(
  stage_id: '3PJ8PZhZZa1eEdd2DtPNtVup'
))

unless res.put_ats_applications_application_id_stage_positive_response.nil?
  # handle response
end

from kombo import Kombo


with Kombo(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as k_client:

    res = k_client.ats.move_application_to_stage(application_id="GRKdd9dibYKKCrmGRSMJf3wu", stage_id="3PJ8PZhZZa1eEdd2DtPNtVup")

    # Handle response
    print(res)

curl --request PUT \
  --url https://api.kombo.dev/v1/ats/applications/{application_id}/stage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '
{
  "stage_id": "3PJ8PZhZZa1eEdd2DtPNtVup"
}
'

const options = {
  method: 'PUT',
  headers: {
    'X-Integration-Id': '<x-integration-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({stage_id: '3PJ8PZhZZa1eEdd2DtPNtVup'})
};

fetch('https://api.kombo.dev/v1/ats/applications/{application_id}/stage', 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://api.kombo.dev/v1/ats/applications/{application_id}/stage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'stage_id' => '3PJ8PZhZZa1eEdd2DtPNtVup'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Integration-Id: <x-integration-id>"
  ],
]);

$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://api.kombo.dev/v1/ats/applications/{application_id}/stage"

	payload := strings.NewReader("{\n  \"stage_id\": \"3PJ8PZhZZa1eEdd2DtPNtVup\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-Integration-Id", "<x-integration-id>")
	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.put("https://api.kombo.dev/v1/ats/applications/{application_id}/stage")
  .header("X-Integration-Id", "<x-integration-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"stage_id\": \"3PJ8PZhZZa1eEdd2DtPNtVup\"\n}")
  .asString();

{
  "status": "success",
  "data": {},
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}

PUT

ats

applications

{application_id}

stage

TypeScript

import { Kombo } from "@kombo-api/sdk";

const kombo = new Kombo({
  integration_id: "workday:HWUTwvyx2wLoSUHphiWVrp28",
  api_key: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await kombo.ats.moveApplicationToStage({
    application_id: "GRKdd9dibYKKCrmGRSMJf3wu",
    body: {
      stage_id: "3PJ8PZhZZa1eEdd2DtPNtVup",
    },
  });

  console.log(result);
}

run();

require 'kombo'

Models = ::Kombo::Models
s = ::Kombo::Kombo.new(
  integration_id: 'workday:HWUTwvyx2wLoSUHphiWVrp28',
  security: Models::Shared::Security.new(
    api_key: '<YOUR_BEARER_TOKEN_HERE>'
  )
)
res = s.ats.move_application_to_stage(application_id: 'GRKdd9dibYKKCrmGRSMJf3wu', body: Models::Shared::PutAtsApplicationsApplicationIdStageRequestBody.new(
  stage_id: '3PJ8PZhZZa1eEdd2DtPNtVup'
))

unless res.put_ats_applications_application_id_stage_positive_response.nil?
  # handle response
end

from kombo import Kombo


with Kombo(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as k_client:

    res = k_client.ats.move_application_to_stage(application_id="GRKdd9dibYKKCrmGRSMJf3wu", stage_id="3PJ8PZhZZa1eEdd2DtPNtVup")

    # Handle response
    print(res)

curl --request PUT \
  --url https://api.kombo.dev/v1/ats/applications/{application_id}/stage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '
{
  "stage_id": "3PJ8PZhZZa1eEdd2DtPNtVup"
}
'

const options = {
  method: 'PUT',
  headers: {
    'X-Integration-Id': '<x-integration-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({stage_id: '3PJ8PZhZZa1eEdd2DtPNtVup'})
};

fetch('https://api.kombo.dev/v1/ats/applications/{application_id}/stage', 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://api.kombo.dev/v1/ats/applications/{application_id}/stage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'stage_id' => '3PJ8PZhZZa1eEdd2DtPNtVup'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Integration-Id: <x-integration-id>"
  ],
]);

$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://api.kombo.dev/v1/ats/applications/{application_id}/stage"

	payload := strings.NewReader("{\n  \"stage_id\": \"3PJ8PZhZZa1eEdd2DtPNtVup\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-Integration-Id", "<x-integration-id>")
	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.put("https://api.kombo.dev/v1/ats/applications/{application_id}/stage")
  .header("X-Integration-Id", "<x-integration-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"stage_id\": \"3PJ8PZhZZa1eEdd2DtPNtVup\"\n}")
  .asString();

{
  "status": "success",
  "data": {},
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}

Supported integrations

This feature is currently available for the following integrations:

You’d like to see this feature for another integration? Please reach out! We’re always happy to discuss extending our coverage.

This endpoint requires the permission Set application stage to be enabled in your scope config.

Example Request Body

{
  "stage_id": "3PJ8PZhZZa1eEdd2DtPNtVup",
  "remote_fields": {}
}

Authorizations

Authorization

string

header

required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

X-Integration-Id

string

required

ID of the integration you want to interact with.

Path Parameters

application_id

string

required

The Kombo ID of the application you want to move to a different stage.

Body

application/json

PUT /ats/applications/:application_id/stage Request body

stage_id

string

required

The Kombo ID of the stage to move the application to. This stage must be allowed for the job that the application is connected to. Get available stages from the stages property on the job, not from the deprecated application-stages endpoint.

remote_fields

object

Additional fields that we will pass through to specific ATS systems.

Show child attributes

Response

PUT /ats/applications/:application_id/stage Positive response

status

string

required

Allowed value: "success"

data

object

required

Example:

{}

warnings

object[]

required

These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.

Show child attributes

​Example Request Body

Authorizations

Headers

Path Parameters

Body

Response

Example Request Body