Skip to main content
POST
Update an applicant's status

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Body

application/json

Update an applicant's status on a job. Validated inline by the use-case (all three fields required).

userId
string
required

The applicant's user ID.

jobId
string
required

The job ID.

newStatus
enum<string>
required

The new status. Setting 'Accepted' awards XP to the applicant.

Available options:
Waiting Review,
Viewed,
Accepted,
Declined

Response

Status update confirmation.

data
object
required