Sign in

v1

latestOpenAPI 3.1.02026-07-1276185442.2 KB
Candidates

Update Candidate

patch/unified/ats/candidates/{id}

Path parameters

idstring required

Headers

x-account-idstring required

The account identifier

Preferstring
Example:heartbeat

Set to "heartbeat" to enable keep-alive newline heartbeats during long-running requests. Response includes Preference-Applied: heartbeat header when honored. (RFC 7240)

Request body

passthroughobject nullable

Value to pass through to the provider

unified_custom_fieldsobject nullable

Custom Unified Fields configured in your StackOne project

namestring nullable

Candidate name

first_namestring nullable

Candidate first name

last_namestring nullable

Candidate last name

emailstring nullable

Candidate email

phonestring nullable

Candidate phone number

companystring nullable

Candidate company

titlestring nullable

Candidate title

application_idsstring[] nullable

List of candidate application IDs

hired_atstring date-time nullable

Candidate hired date

countrystring nullable

Candidate country

Example request

{
  "passthrough": {
    "other_known_names": "John Doe"
  },
  "unified_custom_fields": {
    "my_project_custom_field_1": "REF-1236",
    "my_project_custom_field_2": "some other value"
  },
  "name": "Romain Sestier",
  "first_name": "Romain",
  "last_name": "Sestier",
  "email": "sestier.romain123@gmail.com",
  "emails": [
    {
      "type": "personal",
      "value": "sestier.romain123@gmail.com"
    }
  ],
  "social_links": [
    {
      "type": "linkedin",
      "url": "https://www.linkedin.com/in/romainsestier/"
    }
  ],
  "phone": "+16178294093",
  "phone_numbers": [
    {
      "phone": "+447700112233"
    }
  ],
  "company": "Company Inc.",
  "title": "Software Engineer",
  "application_ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "523e1234-e89b-fdd2-a456-762545121101"
  ],
  "hired_at": "2021-01-01T01:01:01.000Z",
  "country": "United States",
  "custom_fields": [
    {
      "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "name": "Training Completion Status",
      "value_id": "value_456",
      "remote_value_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48"
    }
  ]
}

Response

The candidate was successfully updated.

statusCodenumber required
messagestring required
timestampstring date-time required

Example response

{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}