Succession Plan

List Succession Plans

Changed on

Search and get a list of succession plans based on the search parameters given

get/api/v2/careerhub/succession_plans

Request

Query parameters

startinteger

Specifies the offset value to start for the page

limitinteger

Specifies the number of entries to be returned for the page

incumbentIdsstring

This specifies list of incumbent profile IDs. If this is given, only plans that have incumbents who match the specified profile IDs are returned. The format should be comma-separated values with or without spaces (ex. 1000,2000, 3000).

successorIdsstring

This specifies a list of successor profile IDs. If this is given, only plans where any of the specified profiles is an active successor are returned. Each ID may be numeric or encoded. For user-token (JWT) callers, the request fails with a 403 if the caller does not have manager or HRBP access to every specified profile, and the returned plans are limited to those the caller is allowed to view; totalCount then reflects the number of plans returned on the current page after view-access filtering, not a global count to paginate against. The format should be comma-separated values with or without spaces (ex. 1000,2000, 3000).

querystring

Wildcard text used when searching for the results

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

Changes

    • info

      added the new optional query request parameter successorIds

    • info

      the response property //// became required for the status