Create a library goal
post
/hcmRestApi/resources/11.13.18.05/libraryGoals
Request
Header Parameters
-
Metadata-Context: string
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: string
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.
-
Upsert-Mode: string
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
BusinessUnitId: number
Unique identifier for the business unit associated with the library goal.
-
Comments: string
Title:
CommentsMaximum Length:4000Comments added to the library goal. -
ContentTypeId: integer
(int64)
Title:
Content TypeDefault Value:124Unique identifier for the content type associated with the library goal. -
DateTo: string
(date)
Title:
To DateEnd date of the library goal. -
DepartmentId: number
Unique identifier for the department associated with the library goal.
-
Description: string
Title:
DescriptionMaximum Length:4000Description of the library goal. -
DevCategoryCode: string
Title:
CategoryMaximum Length:30Category code of the development library goal. -
GoalExternalId: string
Title:
External IDMaximum Length:30Unique external identifier for the library goal. -
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the library goal. -
GoalName(required): string
Title:
Goal NameMaximum Length:700Name of the library goal. -
GoalSubTypeCode: string
Maximum Length:
30Subtype code of the library goal. -
GoalUrl: string
Title:
Related LinkMaximum Length:4000Uniform Resource Locator of the library goal. -
JobFamilyId: number
Unique identifier for the job family associated with the library goal.
-
JobId: number
Unique identifier for the job associated with the library goal.
-
LegalEmployerId: number
Unique identifier for the legal employer associated with the library goal.
-
LevelCode: string
Maximum Length:
30Level code of the library goal. -
libGoalTargetOutcomes: array
Library Goal Target Outcomes
Title:
Library Goal Target OutcomesThe libGoalTargetOutcomes resource is a child of the libraryGoals resource and provides all the target outcomes of library goals. -
libraryGoalMeasures: array
Library Goal Measures
Title:
Library Goal MeasuresThe libraryGoalMeasures resource is a child of the libraryGoals resource and provides all the measurements for library goals. -
libraryGoalsDFF: array
libraryGoalsDFF
-
libraryGoalTasks: array
Library Goal Tasks
Title:
Library Goal TasksThe libraryGoalTasks resource is a child of the libraryGoals resource and provides all the tasks for library goals. -
LongDescription: string
(byte)
Long description of the goal.
-
PerfCategoryCode: string
Title:
CategoryMaximum Length:30Category code of the performance library goal. -
PriorityCode: string
Maximum Length:
30Priority code of the library goal. -
StartDate: string
(date)
Start date of the library goal.
-
StatusCode: string
Maximum Length:
30Status code of the library goal. -
SuccessCriteria: string
Maximum Length:
4000Success criteria of the library goal. -
TargetCompletionDate: string
(date)
Target completion date of the library goal.
-
TypeCode: string
Maximum Length:
30Code that indicates the type of library goal. -
Visible: string
Maximum Length:
30Indicates who can view the library goal. The goal can be viewed only by the HR specialist, only by the HR specialist and manager, or HR specialist, manager, and worker.
Nested Schema : Library Goal Target Outcomes
Type:
arrayTitle:
Library Goal Target OutcomesThe libGoalTargetOutcomes resource is a child of the libraryGoals resource and provides all the target outcomes of library goals.
Show Source
Nested Schema : Library Goal Measures
Type:
arrayTitle:
Library Goal MeasuresThe libraryGoalMeasures resource is a child of the libraryGoals resource and provides all the measurements for library goals.
Show Source
Nested Schema : Library Goal Tasks
Type:
arrayTitle:
Library Goal TasksThe libraryGoalTasks resource is a child of the libraryGoals resource and provides all the tasks for library goals.
Show Source
Nested Schema : libraryGoals-libGoalTargetOutcomes-item-post-request
Type:
Show Source
object-
ContentItemRlatId: integer
(int64)
Title:
Content Item Relationship IDUnique identifier for the content item added as a target outcome. -
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the goal associated with the target outcome. -
RelationshipCode: string
Title:
RelationshipMaximum Length:30Default Value:SUPPORTSCode that indicates the relationship type of the content item added as a target outcome. -
TypeId: integer
(int64)
Title:
Related Content TypeUnique identifier for the content type added as a target outcome. -
TypeItemId: integer
(int64)
Title:
Related Content ItemUnique identifier for the content item type added as a target outcome.
Nested Schema : libraryGoals-libraryGoalMeasures-item-post-request
Type:
Show Source
object-
ActualValue: number
Actual value of the library goal's measurement.
-
BusinessGroupId: integer
(int64)
Title:
Business Group IDUnique identifier for the business group for which the library goal's measurement applies. -
Comments: string
Title:
Full Content Item DescriptionMaximum Length:4000Comments about the library goal's measurement. -
EndDate: string
(date)
End date of the library goal measurement.
-
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the library goal for which the measurement applies. -
MaximumTarget: number
Maximum target of the library goal measurement.
-
MeasurementContentId: integer
(int64)
Title:
Content Item IDUnique identifier for the measurement of a library goal used to associate it with its components such as the measurement name, and measurement start date. -
MeasurementId: integer
(int64)
Title:
Content Item Relationship IDUnique identifier for the measurement of a library goal. -
MeasurementName: string
Title:
NameMaximum Length:700Name of the measurement of a library goal. -
MeasureTypeCode: string
Maximum Length:
30Default Value:QUALITATIVECode that indicates the measurement type of the measurement associated with the library goal. -
MinimumTarget: number
Minimum target of the library goal measurement.
-
StartDate: string
(date)
Start date of the library goal measurement.
-
TargetPercentage: number
Target percentage of the library goal measurement.
-
TargetTypeCode: string
Maximum Length:
30Target type code of the library goal measurement. -
TargetValue: number
Target value of the library goal measurement.
-
UomCode: string
Maximum Length:
30Unit of measure code of the library goal's measurement.
Nested Schema : libraryGoals-libraryGoalsDFF-item-post-request
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
BusinessGroupId: integer
(int64)
Title:
Business Group ID -
ContentItemId: integer
(int64)
Title:
Content Item ID
Nested Schema : libraryGoals-libraryGoalTasks-item-post-request
Type:
Show Source
object-
AchievedWeight: number
Achieved weight for the measurement of the library goal's task.
-
ActualCompletionDate: string
(date)
Actual completion date for the measurement of the library goal's task.
-
ActualValue: number
Actual value for the measurement of the library goal's task.
-
BusinessGroupId: integer
(int64)
Title:
Business Group IDUnique identifier for the business group for which the library goal's task applies. -
Comments: string
Title:
Full Content Item DescriptionMaximum Length:4000Comments about the library goal task. -
CompletionStatus: string
Maximum Length:
4000Completion status for the measurement of the library goal's task. -
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the library goal for which the task applies. -
MaximumTarget: number
Maximum target for the measurement of the library goal's task.
-
MinimumTarget: number
Minimum target for the measurement of the library goal's task.
-
PercentCompletion: string
Title:
Completion PercentageMaximum Length:30Completion percentage of the library goal's task. -
PriorityCode: string
Title:
PriorityMaximum Length:30Priority code of the library goal's task. -
RelatedLink: string
Title:
Related LinkMaximum Length:4000Related link of the library goal's task. -
StartDate: string
(date)
Start date of the library goal's task.
-
StatusCode: string
Maximum Length:
30Status code of the library goal's task. -
TargetCompletionDate: string
(date)
Target completion date for the library goal's task.
-
TargetPercentage: number
Target percentage for the measurement of the library goal's task.
-
TargetType: string
Maximum Length:
4000Code for the target type of the library goal's task. -
TargetValue: number
Target value of the library goal's task.
-
TaskContentId: integer
(int64)
Title:
Content Item IDUnique identifier for the task of a library goal used to associate it with its components such as the task name, and task start date. -
TaskId: integer
(int64)
Title:
Content Item Relationship IDUnique identifier for the task of a library goal. -
TaskName: string
Title:
NameMaximum Length:700Name of the task of a library goal. -
TaskTypeCode: string
Title:
TypeMaximum Length:30Task type code of the library goal's task. -
UomCode: string
Maximum Length:
4000Code for the unit of measure of the library goal's task.
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 : libraryGoals-item-response
Type:
Show Source
object-
AvailableTo: string
Title:
Available ToRead Only:trueMaximum Length:80Indicates the roles that have access to the library goal. The library goal can be made available only to HR specialists, or can also be made available to managers and workers. -
BusinessUnitId: number
Unique identifier for the business unit associated with the library goal.
-
BusinessUnitName: string
Title:
Business UnitRead Only:trueMaximum Length:240Name of the business unit associated with the library goal. -
Comments: string
Title:
CommentsMaximum Length:4000Comments added to the library goal. -
ContentTypeId: integer
(int64)
Title:
Content TypeDefault Value:124Unique identifier for the content type associated with the library goal. -
DateTo: string
(date)
Title:
To DateEnd date of the library goal. -
DepartmentId: number
Unique identifier for the department associated with the library goal.
-
DepartmentName: string
Title:
DepartmentRead Only:trueMaximum Length:240Name of the department associated with the library goal. -
Description: string
Title:
DescriptionMaximum Length:4000Description of the library goal. -
DevCategoryCode: string
Title:
CategoryMaximum Length:30Category code of the development library goal. -
DevCategoryMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Category of the development library goal. -
GoalExternalId: string
Title:
External IDMaximum Length:30Unique external identifier for the library goal. -
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the library goal. -
GoalName: string
Title:
Goal NameMaximum Length:700Name of the library goal. -
GoalSubTypeCode: string
Maximum Length:
30Subtype code of the library goal. -
GoalSubTypeMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Subtype of the library goal. Subtypes are configured based on business requirements. -
GoalUrl: string
Title:
Related LinkMaximum Length:4000Uniform Resource Locator of the library goal. -
JobFamilyId: number
Unique identifier for the job family associated with the library goal.
-
JobFamilyName: string
Title:
Job FamilyRead Only:trueMaximum Length:240Name of the job family associated with the library goal. -
JobId: number
Unique identifier for the job associated with the library goal.
-
LastUpdateDate: string
(date-time)
Read Only:
trueDate the library goal was last updated. -
LegalEmployerId: number
Unique identifier for the legal employer associated with the library goal.
-
LegalEmployerName: string
Title:
Legal EmployerRead Only:trueMaximum Length:255Name of the legal employer associated with the library goal. -
LevelCode: string
Maximum Length:
30Level code of the library goal. -
LevelMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Level of the library goal. -
libGoalTargetOutcomes: array
Library Goal Target Outcomes
Title:
Library Goal Target OutcomesThe libGoalTargetOutcomes resource is a child of the libraryGoals resource and provides all the target outcomes of library goals. -
libraryGoalMeasures: array
Library Goal Measures
Title:
Library Goal MeasuresThe libraryGoalMeasures resource is a child of the libraryGoals resource and provides all the measurements for library goals. -
libraryGoalsDFF: array
libraryGoalsDFF
-
libraryGoalTasks: array
Library Goal Tasks
Title:
Library Goal TasksThe libraryGoalTasks resource is a child of the libraryGoals resource and provides all the tasks for library goals. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
LongDescription: string
(byte)
Long description of the goal.
-
PerfCategoryCode: string
Title:
CategoryMaximum Length:30Category code of the performance library goal. -
PerfCategoryMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Category of the performance library goal. -
PriorityCode: string
Maximum Length:
30Priority code of the library goal. -
PriorityMeaning: string
Title:
PriorityRead Only:trueMaximum Length:80Priority of the library goal. -
StartDate: string
(date)
Start date of the library goal.
-
StatusCode: string
Maximum Length:
30Status code of the library goal. -
StatusMeaning: string
Title:
StatusRead Only:trueMaximum Length:80Status of the library goal. -
SuccessCriteria: string
Maximum Length:
4000Success criteria of the library goal. -
TargetCompletionDate: string
(date)
Target completion date of the library goal.
-
TypeCode: string
Maximum Length:
30Code that indicates the type of library goal. -
TypeMeaning: string
Title:
TypeRead Only:trueMaximum Length:80Type of library goal. -
Visible: string
Maximum Length:
30Indicates who can view the library goal. The goal can be viewed only by the HR specialist, only by the HR specialist and manager, or HR specialist, manager, and worker.
Nested Schema : Library Goal Target Outcomes
Type:
arrayTitle:
Library Goal Target OutcomesThe libGoalTargetOutcomes resource is a child of the libraryGoals resource and provides all the target outcomes of library goals.
Show Source
Nested Schema : Library Goal Measures
Type:
arrayTitle:
Library Goal MeasuresThe libraryGoalMeasures resource is a child of the libraryGoals resource and provides all the measurements for library goals.
Show Source
Nested Schema : Library Goal Tasks
Type:
arrayTitle:
Library Goal TasksThe libraryGoalTasks resource is a child of the libraryGoals resource and provides all the tasks for library goals.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : libraryGoals-libGoalTargetOutcomes-item-response
Type:
Show Source
object-
ContentItemRlatId: integer
(int64)
Title:
Content Item Relationship IDUnique identifier for the content item added as a target outcome. -
ContentTypeName: string
Title:
TypeRead Only:trueMaximum Length:240Name of the content type added as a target outcome. -
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the goal associated with the target outcome. -
ItemDescription: string
Title:
Item DescriptionRead Only:trueMaximum Length:2000Item description of the target outcome. -
LastUpdateDate: string
(date-time)
Read Only:
trueDate the target outcome was last updated. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
NameRead Only:trueMaximum Length:700Name of content item added as a target outcome. -
RelationshipCode: string
Title:
RelationshipMaximum Length:30Default Value:SUPPORTSCode that indicates the relationship type of the content item added as a target outcome. -
TypeId: integer
(int64)
Title:
Related Content TypeUnique identifier for the content type added as a target outcome. -
TypeItemId: integer
(int64)
Title:
Related Content ItemUnique identifier for the content item type added as a target outcome.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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.
Nested Schema : libraryGoals-libraryGoalMeasures-item-response
Type:
Show Source
object-
ActualValue: number
Actual value of the library goal's measurement.
-
BusinessGroupId: integer
(int64)
Title:
Business Group IDUnique identifier for the business group for which the library goal's measurement applies. -
Comments: string
Title:
Full Content Item DescriptionMaximum Length:4000Comments about the library goal's measurement. -
CreatedBy: string
Read Only:
trueMaximum Length:64User who created the library goal measurement. -
CreationDate: string
(date-time)
Read Only:
trueDate when the library goal measurement was created. -
EndDate: string
(date)
End date of the library goal measurement.
-
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the library goal for which the measurement applies. -
LastUpdateDate: string
(date-time)
Read Only:
trueDate when the library goal measurement was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64User who the last updated the library goal measurement. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MaximumTarget: number
Maximum target of the library goal measurement.
-
MeasurementContentId: integer
(int64)
Title:
Content Item IDUnique identifier for the measurement of a library goal used to associate it with its components such as the measurement name, and measurement start date. -
MeasurementId: integer
(int64)
Title:
Content Item Relationship IDUnique identifier for the measurement of a library goal. -
MeasurementName: string
Title:
NameMaximum Length:700Name of the measurement of a library goal. -
MeasureTypeCode: string
Maximum Length:
30Default Value:QUALITATIVECode that indicates the measurement type of the measurement associated with the library goal. -
MinimumTarget: number
Minimum target of the library goal measurement.
-
StartDate: string
(date)
Start date of the library goal measurement.
-
TargetPercentage: number
Target percentage of the library goal measurement.
-
TargetTypeCode: string
Maximum Length:
30Target type code of the library goal measurement. -
TargetTypeMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Target type of the library goal measurement. -
TargetValue: number
Target value of the library goal measurement.
-
UomCode: string
Maximum Length:
30Unit of measure code of the library goal's measurement. -
UomMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Unit of measure of the library goal's measurement.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : libraryGoals-libraryGoalsDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
BusinessGroupId: integer
(int64)
Title:
Business Group ID -
ContentItemId: integer
(int64)
Title:
Content Item ID -
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : libraryGoals-libraryGoalTasks-item-response
Type:
Show Source
object-
AchievedWeight: number
Achieved weight for the measurement of the library goal's task.
-
ActualCompletionDate: string
(date)
Actual completion date for the measurement of the library goal's task.
-
ActualValue: number
Actual value for the measurement of the library goal's task.
-
BusinessGroupId: integer
(int64)
Title:
Business Group IDUnique identifier for the business group for which the library goal's task applies. -
Comments: string
Title:
Full Content Item DescriptionMaximum Length:4000Comments about the library goal task. -
CompletionStatus: string
Maximum Length:
4000Completion status for the measurement of the library goal's task. -
CreatedBy: string
Read Only:
trueMaximum Length:64User who created the library goal task. -
CreationDate: string
(date-time)
Read Only:
trueDate when the library goal task was created. -
GoalId: integer
(int64)
Title:
Content Item IDUnique identifier for the library goal for which the task applies. -
LastUpdateDate: string
(date-time)
Read Only:
trueDate when the library goal task was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64User who last updated the library goal task. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MaximumTarget: number
Maximum target for the measurement of the library goal's task.
-
MinimumTarget: number
Minimum target for the measurement of the library goal's task.
-
PercentCompletion: string
Title:
Completion PercentageMaximum Length:30Completion percentage of the library goal's task. -
PriorityCode: string
Title:
PriorityMaximum Length:30Priority code of the library goal's task. -
PriorityMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Priority of the library goal's task. -
RelatedLink: string
Title:
Related LinkMaximum Length:4000Related link of the library goal's task. -
StartDate: string
(date)
Start date of the library goal's task.
-
StatusCode: string
Maximum Length:
30Status code of the library goal's task. -
StatusMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Status of the library goal's task. -
TargetCompletionDate: string
(date)
Target completion date for the library goal's task.
-
TargetPercentage: number
Target percentage for the measurement of the library goal's task.
-
TargetType: string
Maximum Length:
4000Code for the target type of the library goal's task. -
TargetTypeMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Description for the target type of the library goal's task. -
TargetValue: number
Target value of the library goal's task.
-
TaskContentId: integer
(int64)
Title:
Content Item IDUnique identifier for the task of a library goal used to associate it with its components such as the task name, and task start date. -
TaskId: integer
(int64)
Title:
Content Item Relationship IDUnique identifier for the task of a library goal. -
TaskName: string
Title:
NameMaximum Length:700Name of the task of a library goal. -
TaskTypeCode: string
Title:
TypeMaximum Length:30Task type code of the library goal's task. -
TaskTypeMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Task type of the library goal's task. -
UomCode: string
Maximum Length:
4000Code for the unit of measure of the library goal's task. -
UomCodeMeaning: string
Title:
MeaningRead Only:trueMaximum Length:80Unit of measure of the library goal's task.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- libGoalTargetOutcomes
-
Operation: /hcmRestApi/resources/11.13.18.05/libraryGoals/{libraryGoalsUniqID}/child/libGoalTargetOutcomesParameters:
- libraryGoalsUniqID:
$request.path.libraryGoalsUniqID
The libGoalTargetOutcomes resource is a child of the libraryGoals resource and provides all the target outcomes of library goals. - libraryGoalsUniqID:
- libraryGoalMeasures
-
Operation: /hcmRestApi/resources/11.13.18.05/libraryGoals/{libraryGoalsUniqID}/child/libraryGoalMeasuresParameters:
- libraryGoalsUniqID:
$request.path.libraryGoalsUniqID
The libraryGoalMeasures resource is a child of the libraryGoals resource and provides all the measurements for library goals. - libraryGoalsUniqID:
- libraryGoalTasks
-
Operation: /hcmRestApi/resources/11.13.18.05/libraryGoals/{libraryGoalsUniqID}/child/libraryGoalTasksParameters:
- libraryGoalsUniqID:
$request.path.libraryGoalsUniqID
The libraryGoalTasks resource is a child of the libraryGoals resource and provides all the tasks for library goals. - libraryGoalsUniqID:
- libraryGoalsDFF
-
Operation: /hcmRestApi/resources/11.13.18.05/libraryGoals/{libraryGoalsUniqID}/child/libraryGoalsDFFParameters:
- libraryGoalsUniqID:
$request.path.libraryGoalsUniqID
- libraryGoalsUniqID: