Sign in

0fb26f4e41bf

latestOpenAPI 3.0.22026-07-26191278525.6 KB
Succession Plan

Get Succession Plan

Given a position ID of the succession plan, return attributes of the plan

get/api/v2/careerhub/succession_plans/{positionId}

Path parameters

positionIdinteger required

Eightfold position ID associated with the succession plan

Query parameters

excludestring

Exclude specific fields in the response. Possible values are the names of the top level fields present in corresponding API schema. To check API schema, expand the response section below.

keyListstring

Allows selective control over the fields returned in the API response. If the keyList is empty, all fields will be returned. Possible values are the names of the top level fields present in corresponding API schema. To check API schema, expand the response section below.

Headers

Authorizationstring required

The secret key to access the api. It starts with the bearer token

Response

OK

createdAtinteger nullable

Timestamp representing creation date and time of the succession plan

associatedRoleIdstring nullable

Eightfold role ID associated with the succession plan

jobCodestring nullable

External job code of the incumbent(s)

entityIdstring nullable

ATS/HRIS position ID associated with the plan

positionCriticalityTagsstring[] nullable

Criticality tags of the succession plan that is associated with the position held by the incumbent

planTypestring nullable

Type of the succession plan Ex. either "position" or "role" (only honored for POST)

planNamestring nullable

Name of the succession plan

updatedAtinteger nullable

Timestamp representing the updation date and time of the succession plan

roleCriticalityTagsstring[] nullable

Criticality tags of the role that is associated with the position held by the incumbent

positionIdinteger required

Eightfold position ID associated with the succession plan

descriptionstring nullable

Description of the succession plan