Applications

Update application

Updates application-level fields such as stage, disqualification flag, and CV. Passing stage_id performs a full stage transition and runs the target stage's workflow automation (nurture campaigns, emails, scoring), exactly as POST /applications/{id}/move does. Supports external pipeline management and data correction flows.

put/applications/{id}

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/applications/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Resource ID (numeric).

Query parameters

includestring

Comma-separated list of related resources to include. Supported: candidate — full candidate profile, cv.text — parsed plain-text CV content, job — full job payload with url_backoffice for UI deep-linking.

Request body

stage_idinteger

Move application to this pipeline stage. Runs the target stage's workflow automation.

is_disqualifiedboolean

Set to true to disqualify the candidate on this application.

Response

Updated application

idinteger required

Unique identifier

candidate_idinteger required

ID of the candidate

job_idinteger required

ID of the job

job_aliasstring nullable

Short alias of the job, usable in URLs (e.g. 79SZHfT)

internal_job_idstring nullable

Company's internal job identifier

company_idinteger required

ID of the company

url_backofficestring uri

Absolute backoffice URL of the application's view (candidate page in this job) in the 100Hires recruiter app. Use to render deep-links in agent UIs.

status'active' | 'hired' | 'rejected' required

Application status. Changes via hire/reject/unreject actions.

is_disqualifiedboolean required

Whether the candidate is disqualified for this application

rejected_atinteger nullable

Unix timestamp (seconds)

hired_atinteger nullable

Unix timestamp (seconds)

custom_fieldsobject nullable

Custom field values as key-value pairs

ai_scoreinteger nullable

AI-generated candidate fit score (0-100)

ai_recommendationstring nullable

AI-generated recommendation label (e.g. Strong, Good, Weak)

ai_scoring_updated_atinteger nullable

Unix timestamp (seconds) of the latest completed AI scoring result

created_atinteger required

Unix timestamp (seconds)

updated_atinteger required

Unix timestamp (seconds)

last_message_atinteger nullable

Unix timestamp (seconds) of the most recent message (email or SMS) sent to or received from the candidate in this application's company. Null if no messages exist.

days_since_last_messageinteger nullable

Number of whole days since the last message. Computed at request time. Null if no messages exist.

Example response

{
  "job_alias": "79SZHfT",
  "url_backoffice": "https://app.100hires.com/candidate/dtGeby2/79SZHfT",
  "job": {
    "alias": "79SZHfT",
    "language": "de-DE"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.