v1

latestOpenAPI 3.1.02026-07-224239180.9 KB

Interviewer

Update an interviewer

Updates the admin-managed interviewer profile, scheduling controls, load-limit overrides, and organization attributes. Example: {"title":"Principal Engineer","timezone":"America/Chicago","daily_load_limit":{"limit":4,"type":"NUMBER_OF_INTERVIEWS"}}. Set nullable overrides to null to clear them. Email and ATS identity are read-only. Requires a WRITE-scoped token with the interviewers:write entitlement. Changes are attributed to the acting employee in API and backend audit telemetry; this administrative update does not create a scheduling activity-timeline entry. Directory- or HRIS-managed profile fields may be overwritten by a later sync.

patch/v1/interviewers/{interviewerId}

Path parameters

interviewerIdstring required

an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.

Example:emp_a1b2c3d4e5f64789a1b2c3d4e5f64789

Request body

titlestring

Use an empty string to clear the title; null is not supported by the backend.

timezonestring nullable

phone_numberstring nullable

linkedin_urlstring uri nullable

manager_idstring nullable

an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.

given_namestring

family_namestring

full_namestring

Example request

{
  "manager_id": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "attributes": [
    {
      "attribute_name_id": "att_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "value_ids": [
        "atv_a1b2c3d4e5f64789a1b2c3d4e5f64789"
      ]
    }
  ]
}

Response

Success

idstring required

Canonical employee ID (emp_ followed by 32 lowercase hexadecimal UUID characters).

namestring required

emailstring email required

titlestring nullable required

timezonestring nullable required

manager_idstring nullable required

Canonical employee ID (emp_ followed by 32 lowercase hexadecimal UUID characters).

created_atstring date-time required

ISO 8601 timestamp.

updated_atstring date-time required

ISO 8601 timestamp.

Example response

{
  "id": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "manager_id": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "attributes": [
    {
      "attribute_name": {
        "id": "att_a1b2c3d4e5f64789a1b2c3d4e5f64789"
      },
      "values": [
        {
          "id": "atv_a1b2c3d4e5f64789a1b2c3d4e5f64789"
        }
      ]
    }
  ],
  "modules": [
    {
      "module": {
        "id": "mod_a1b2c3d4e5f64789a1b2c3d4e5f64789"
      }
    }
  ]
}