EIeightfold
Upskill Plan Assignment

Create Upskill Plan Assignment

Changed on

Create an assigned upskilling plan for the given employee from an external system. 409 with the existing planId if externalId already exists for this profile. sections is optional. When it is omitted, the plan is created with one empty section.

post/api/v2/careerhub/{profileEncId}/upskill-plan-assignment

Request

Path parameters

profileEncIdstring required

Encoded profile id: id from GET /api/v2/core/employees

Headers

Authorizationstring required

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

Request body

externalIdstring nullable

Your external record id, unique per assignee. Addresses the plan in the /ext/<externalId> paths.

planSubtypestring nullable

Plan subtype, one of the subtypes configured for your account. Defaults to general.

namestring nullable required

Plan title

planDurationDaysinteger nullable

Plan duration in days. Rounded down to whole weeks, at most 693; values under 7 leave it unset.

creatorProfileIdstring nullable

Encoded profile id of the plan creator, from GET /api/v2/core/employees. Must be a user who can sign in; the creator can edit the plan. Required for API-key callers. A signed-in caller is the creator: omit it, or send your own id.

skillsstring[]

Skill names the plan develops. A task's skills must come from this list.

targetDateinteger nullable

Target completion date (epoch seconds)

descriptionstring nullable

Plan description

associatedRoleIdsstring[]

Role ids, as returned by GET /api/v2/JIE/roles.

Response

OK

createdAtinteger nullable

Created timestamp (epoch seconds)

idinteger nullable

Assignment id (profile_data primary key)

planStatusstring nullable

invited | in_progress | completed | archived

externalIdstring nullable

Your external record id, unique per assignee. Addresses the plan in the /ext/<externalId> paths.

namestring nullable required

Plan display name

userIdstring nullable

Plan creator user id

completionPercentageinteger nullable

Completion percentage 0-100 (derived)

profileIdinteger nullable

Assignee profile id

startDateinteger nullable

Start date (epoch seconds)

lastProgressTsinteger nullable

Last progress timestamp (epoch seconds, system-set)

groupIdstring nullable

Tenant group id

updatedAtinteger nullable

Updated timestamp (epoch seconds)

lastNotifiedTsinteger nullable

Last notification timestamp (epoch seconds, system-set)

targetDateinteger nullable

Target completion date (epoch seconds)

parentPlanIdinteger nullable

Template plan id this assignment was cloned from

Changes