Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Update Talent Work History

Updates the specified work history information for the specified talent record.

put/v1/talent/{talentId}/work-history/{workHistoryId}

Path parameters

talentIdstring required

The identifier for the talent associated with the work history record.

workHistoryIdstring required

The identifier for the work history record to be updated.

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Request body

workHistoryIDinteger

The identifier for the talent work history record.

talentIdinteger required

The identifier for the talent.

companystring

The name of the company where the talent worked.

titlestring

The job title.

fromstring

The employment start date. This is an open-format text field containing the year, and possibly month of the date. For example, 2012, 9/12, 09-2012.

tostring

The employment end date. This is an open-format text field containing the year, and possibly month of the date. For example, 2016, 5/16, 05-2016.

citystring

The city of employment.

statestring

The state/province or region of employment in open-format text.

countrystring

The country of employment in open-format text.

dutiesstring

The duties the talent performed during employment.

reason_For_Leavingstring

The reason for leaving.

notesstring

Additional notes on the talent's work history.

Example request

{
  "workHistoryID": 29184,
  "talentId": 183744,
  "company": "ABC Corp",
  "title": "Warehouse Worker",
  "from": "9/2012",
  "to": "5/2016",
  "city": "Bloomington",
  "state": "MN",
  "country": "US",
  "duties": "Warehouse packing, loading and unloading.",
  "reason_For_Leaving": "Workforce reduction.",
  "notes": "Would rehire."
}

Response

The updated talent work history record.

workHistoryIDinteger

The identifier for the talent work history record.

talentIdinteger required

The identifier for the talent.

companystring

The name of the company where the talent worked.

titlestring

The job title.

fromstring

The employment start date. This is an open-format text field containing the year, and possibly month of the date. For example, 2012, 9/12, 09-2012.

tostring

The employment end date. This is an open-format text field containing the year, and possibly month of the date. For example, 2016, 5/16, 05-2016.

citystring

The city of employment.

statestring

The state/province or region of employment in open-format text.

countrystring

The country of employment in open-format text.

dutiesstring

The duties the talent performed during employment.

reason_For_Leavingstring

The reason for leaving.

notesstring

Additional notes on the talent's work history.

Example response

{
  "workHistoryID": 29184,
  "talentId": 183744,
  "company": "ABC Corp",
  "title": "Warehouse Worker",
  "from": "9/2012",
  "to": "5/2016",
  "city": "Bloomington",
  "state": "MN",
  "country": "US",
  "duties": "Warehouse packing, loading and unloading.",
  "reason_For_Leaving": "Workforce reduction.",
  "notes": "Would rehire."
}