Account Information13

Alerts5

Applicant Tracking10

Benefits10

Calendar Events1

Change Tracking2

Company Files6

Company Profile3

Compensation3

Compensation Benchmarking11

Compensation Planning28

Custom Fields12

Custom Reports4

Custom Tables7

Datasets8

Employee Files6

Employee Tables6

Employee Verification5

Employees8

Field Metadata4

Goals24

Holidays8

Hours1

Locations5

Login1

Meal & Rest Breaks20

Onboarding12

Pay Grades & Bands14

Photos2

Public API5

Recognition Settings1

Reports2

Scheduling21

Time Off37

Time Tracking63

Total Rewards8

Training12

Webhooks8

Webhooks

Webhook Events6

Applicant Tracking

Public API

Update Applicant Status

Update the status of an application. The authenticated caller must have access to ATS settings. Use the Get Applicant Statuses endpoint to obtain valid status IDs.

OAuth Scopes: hiring:applications.write

post/api/v1/applicant_tracking/applications/{applicationId}/status

Request

Base URL
https://companySubDomain.bamboohr.com
Auth
- HTTP basic
- or OAuth 2
  Authorization code/authorize.php
  Token URL/token.php
  Scopeshiring:applications.write
TypeScript
https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/applicant_tracking/applications/:applicationId/status/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

applicationIdinteger required

The ID of the application whose status should be updated.

Request body

statusinteger required

The ID of the status to assign to the application. Use the Get Applicant Statuses endpoint to get available status IDs.

Example request

{
  "status": 2
}

Response

Success. Returns the type and ID of the status change record.

typestring

Always 'positionApplicantStatus'

idinteger

The ID of the created status change record

Changes

No recorded changes to this operation across all 2 revisions of this API.