Update a public skill
patch
/hcmRestApi/resources/11.13.18.05/talentPersonProfiles/{talentPersonProfilesUniqID}/child/publicSkills/{SkillId}
Request
Path Parameters
-
SkillId(required): integer(int64)
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
-
talentPersonProfilesUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Talent Person Profiles resource and used to uniquely identify an instance of Talent Person Profiles. The client should not generate the hash key value. Instead, the client should query on the Talent Person Profiles collection resource in order to navigate to a specific instance of Talent Person Profiles to get the hash key.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
Comments: string
(byte)
Title:
Comments
Comments of the content item. -
DateAchieved: string
(date)
Title:
Date Achieved
Date when skill was achieved. -
Description: string
(byte)
Title:
Description
Description of the skill item. -
endorsements: array
Endorsements
Title:
Endorsements
The endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability. -
Group: string
Title:
Group Code
Maximum Length:30
Code that indicates whether the skill is acquired or developing. Values can be ORA_DEVELOPED or ORA_DEVELOPING. Valid values are defined in the commonLookupsLOV. -
ProficiencyLevelCode: string
Title:
Proficiency Level Code
Maximum Length:30
Code representing the proficiency level of public skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level ID
Unique identifier of the proficiency level in the public skill. -
ProjectName: string
Title:
Project Name or Activities
Maximum Length:2000
Name of the project or activity. -
RelatedItemFlag: boolean
Title:
Related Item
Maximum Length:30
Attribute specific to learning outcome. Indicates whether the public skill item doesn't need to be copied to the learner's talent profiles after completion of the course or specialization. Valid values are Y and N. -
SkillCurationStatus: string
Title:
Skill Curation Status
Maximum Length:30
Code representing the source of skill item. -
SkillCurationType: string
Maximum Length:
30
Code representing the source of skill item. -
SkillType: string
Title:
Skill Type Code
Maximum Length:30
Type of skill. Valid values defined in commonLookupsLOV. -
SourceType: string
Maximum Length:
30
Code representing the source of skill item. -
YearsOfExperience: integer
(int64)
Title:
Years of Experience
Years of experience with the skill.
Nested Schema : Endorsements
Type:
array
Title:
Endorsements
The endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability.
Show Source
Nested Schema : talentPersonProfiles-publicSkills-endorsements-item-patch-request
Type:
Show Source
object
-
ProficiencyLevelCode: string
Title:
Proficiency Level Code
Maximum Length:30
Code representing the proficiency level of the skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level ID
Unique identifier of the proficiency level of the skill. -
Status: string
Title:
Status Code
Maximum Length:30
Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : talentPersonProfiles-publicSkills-item-response
Type:
Show Source
object
-
Comments: string
(byte)
Title:
Comments
Comments of the content item. -
ConfirmationFlag: boolean
Title:
Confirmation Status
Read Only:true
Maximum Length:30
Indicates whether the proficiency level has been confirmed for the public skill. Valid values are true and false. Default value is false. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
User who created the public skill. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date and time when the public skill was created. -
DateAchieved: string
(date)
Title:
Date Achieved
Date when skill was achieved. -
Description: string
(byte)
Title:
Description
Description of the skill item. -
endorsements: array
Endorsements
Title:
Endorsements
The endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability. -
Group: string
Title:
Group Code
Maximum Length:30
Code that indicates whether the skill is acquired or developing. Values can be ORA_DEVELOPED or ORA_DEVELOPING. Valid values are defined in the commonLookupsLOV. -
GroupMeaning: string
Title:
Group
Read Only:true
Maximum Length:80
Meaning of the skill group. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date and time when the public skill was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
User who last updated the public section. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumericRating: number
Title:
Numeric Rating
Read Only:true
Numeric rating of the public skill. -
ProficiencyLevel: string
Title:
Proficiency Level
Read Only:true
Maximum Length:2000
Description or name of the proficiency level of the public skill. -
ProficiencyLevelCode: string
Title:
Proficiency Level Code
Maximum Length:30
Code representing the proficiency level of public skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level ID
Unique identifier of the proficiency level in the public skill. -
ProfileId: integer
(int64)
Surrogate identifier for the person profile.
-
ProjectName: string
Title:
Project Name or Activities
Maximum Length:2000
Name of the project or activity. -
RatingModelId: integer
Title:
Rating Model Id
Read Only:true
Unique identifier of the rating model associated with the public skill content section. -
RelatedItemFlag: boolean
Title:
Related Item
Maximum Length:30
Attribute specific to learning outcome. Indicates whether the public skill item doesn't need to be copied to the learner's talent profiles after completion of the course or specialization. Valid values are Y and N. -
SectionId: integer
(int64)
Unique identifier of the content section.
-
Skill: string
Title:
Skill
Maximum Length:240
Name of the public skill. -
SkillCurationStatus: string
Title:
Skill Curation Status
Maximum Length:30
Code representing the source of skill item. -
SkillCurationType: string
Maximum Length:
30
Code representing the source of skill item. -
SkillId: integer
(int64)
Title:
Skill ID
Read Only:true
Unique identifier for the public skill. -
SkillType: string
Title:
Skill Type Code
Maximum Length:30
Type of skill. Valid values defined in commonLookupsLOV. -
SourceType: string
Maximum Length:
30
Code representing the source of skill item. -
YearsOfExperience: integer
(int64)
Title:
Years of Experience
Years of experience with the skill.
Nested Schema : Endorsements
Type:
array
Title:
Endorsements
The endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : talentPersonProfiles-publicSkills-endorsements-item-response
Type:
Show Source
object
-
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
User who created the endorsement. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
Date and time when the endorsement was created. -
EndorsementId: integer
(int64)
Title:
Endorsement ID
Unique identifier for the endorsement. -
EndorserId: integer
(int64)
Title:
Endorser ID
Unique identifier of the endorser. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date and time when the endorsement was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
User who last updated the endorsement. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
NumericRating: number
Title:
Numeric Rating
Read Only:true
Numeric rating of the skill. -
ProficiencyLevelCode: string
Title:
Proficiency Level Code
Maximum Length:30
Code representing the proficiency level of the skill. -
ProficiencyLevelId: integer
(int64)
Title:
Proficiency Level ID
Unique identifier of the proficiency level of the skill. -
RequestedDate: string
(date-time)
Title:
Requested Date
Read Only:true
Date and time when the endorsement was created. -
RequestorPersonId: integer
(int64)
Title:
Requester Person ID
Unique identifier of the person who has requested the endorsement. -
Status: string
Title:
Status Code
Maximum Length:30
Status of the endorsement. Values can be ORA_COMPLETED or ORA_PENDING or ORA_IGNORE. Valid values are defined in the commonLookupsLOV.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Links
- ProficiencyLevelLOV
-
The following properties are defined on the LOV link relation:
- Source Attribute: ProficiencyLevelCode; Target Attribute: RatingLevelCode
- Display Attribute: NumericRating
- endorsements
-
Parameters:
- SkillId:
$request.path.SkillId
- talentPersonProfilesUniqID:
$request.path.talentPersonProfilesUniqID
The endorsements resource is a child of public skills resource. It provides a list of all endorsements for worker's public skills. This resource is currently under controlled availability. - SkillId:
- groupsLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_HRT_SKILL_GROUP
The following properties are defined on the LOV link relation:- Source Attribute: Group; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- sendEndorsementRequests
-
Parameters:
- SkillId:
$request.path.SkillId
- talentPersonProfilesUniqID:
$request.path.talentPersonProfilesUniqID
Allows users to request other workers to endorse a skill the users have. - SkillId: