EIeightfold
Upskill Plan Template

Create Upskill Plan Template

Changed on

Create an upskilling plan template from an external system. Published unless status says otherwise. 409 with the existing planId if externalId already exists in the tenant. sections is optional. When it is omitted, the plan is created with one empty section.

post/api/v2/careerhub/upskill-plan-templates

Request

Headers

Authorizationstring required

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

Request body

statusstring nullable

Template status: draft | published. Defaults to published.

externalIdstring nullable

Your external record id, unique in the tenant. 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.

descriptionstring nullable

Plan description

associatedRoleIdsstring[]

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

Response

OK

statusstring nullable

Template status: draft | published

idinteger nullable

Template plan id

createdAtinteger nullable

Created timestamp (epoch seconds)

planSubtypestring nullable

Plan subtype

namestring nullable

Plan title

externalIdstring nullable

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

userIdstring nullable

Plan creator user id

planDurationDaysinteger nullable

Plan duration in days

publishedAtinteger nullable

Publish timestamp (epoch seconds)

skillsstring[] nullable

Skill names

groupIdstring nullable

Tenant group id

updatedAtinteger nullable

Updated timestamp (epoch seconds)

descriptionstring nullable

Plan description

associatedRoleIdsstring[] nullable

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

Changes