Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Create a Talent Work History

Adds details about the talent’s previous work experience. This information is displayed on the Work History tab of the talent profile.

post/v1/talent/{talentId}/work-history

Path parameters

talentIdstring required

The identifier for the talent for whom the work history record is being created.

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 work history for the specified talent.

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."
}