Create a Custom Log Item
post
/api/restapi/customLogItem
Send a request to this endpoint to create a custom log item. An application object will be created using the JSON data provided in the request body.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ApiEntityCustomLogItemInput
Type:
objectTitle:
ApiEntityCustomLogItemInputThis entity represents a CustomLogItem object, a unique CustomLogItem object can be identified by the following combinations of the fields.
Show Source
- customLogItemId
- customLogItemCode,customLogTypeObjectId
- customLogItemCode,customLogTypeObjectName,projectId
- customLogItemCode,customLogTypeObjectName,projectCode,workspaceCode
- customLogItemCode,customLogTypeObjectName,programId
- customLogItemCode,customLogTypeObjectName,programCode,workspaceCode
-
ballInCourtId: integer
(int64)
The system-generated identifier of a user.
-
ballInCourtUserName: string
Maximum Length:
255The user-specified identifier of the user associated with the object. -
codeValues: array
codeValues
The list of code values for a custom log item. This entity can only be used to assign codeValues or create codeValues on the fly.
-
comment: string
Minimum Length:
0Maximum Length:4000Notes about the custom log item. -
customLogItemCode: string
Minimum Length:
1Maximum Length:60A unique identifier unique of the custom log item. -
customLogItemId: integer
(int64)
The system-generated identifier of a custom log item. This value should not be provided in create operation request data, however, it is required for update requests.
-
customLogsItemName(required): string
Minimum Length:
0Maximum Length:255The name of the custom log item. -
customLogTypeObjectId(required): integer
(int64)
The unique identifier for the custom log type object.The custom log type object can also be identified by its unique criteria.
-
customLogTypeObjectName: string
Minimum Length:
0Maximum Length:255The user-specified identifier of a custom log type. -
dueDate: string
(date-time)
The date the custom log item is due.
-
programCode: string
Maximum Length:
60The unique identifier for a program set by the user who created the program. -
programId: integer
(int64)
A unique identifier of a Program.
-
projectCode: string
Minimum Length:
1Maximum Length:60The user-specified identifier of a project. -
projectId(required): integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
status: string
Allowed Values:
[ "DRAFT" ]The status of the custom log item. -
udfValues: array
udfValues
An object containing configured fields in the form of key-value pairs.
-
workspaceCode: string
Minimum Length:
0Maximum Length:60The user-specified identifier of a workspace. -
workspaceId: integer
(int64)
The unique identifier of a workspace.
Nested Schema : codeValues
Type:
arrayThe list of code values for a custom log item. This entity can only be used to assign codeValues or create codeValues on the fly.
Show Source
-
Array of:
object ApiEntityCodeValueCustomLogInput
Title:
ApiEntityCodeValueCustomLogInputThis entity represents a CodeValueCustomLog object, a unique CodeValueCustomLog object can be identified by the following combinations of the fields.- codeValueCustomLogId
- codeValueId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeTypeCode,parentId,codeValueCode
- codeValueCode,codeTypeId,parentId
- codeTypeCode,codeValueCode,projectCode
- codeTypeCode,codeValueCode,projectId
- codeTypeCode,codeValueCode,parentId,projectCode
- codeTypeCode,codeValueCode,parentId,projectId
Nested Schema : udfValues
Type:
arrayAn object containing configured fields in the form of key-value pairs.
Show Source
-
Array of:
object ApiEntityCustomLogItemConfiguredFieldValueInput
Title:
ApiEntityCustomLogItemConfiguredFieldValueInputThis entity represents a CustomLogItemConfiguredFieldValue object, a unique CustomLogItemConfiguredFieldValue object can be identified by the following combinations of the fields.- customLogItemConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
Nested Schema : ApiEntityCodeValueCustomLogInput
Type:
objectTitle:
ApiEntityCodeValueCustomLogInputThis entity represents a CodeValueCustomLog object, a unique CodeValueCustomLog object can be identified by the following combinations of the fields.
Show Source
- codeValueCustomLogId
- codeValueId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeTypeCode,parentId,codeValueCode
- codeValueCode,codeTypeId,parentId
- codeTypeCode,codeValueCode,projectCode
- codeTypeCode,codeValueCode,projectId
- codeTypeCode,codeValueCode,parentId,projectCode
- codeTypeCode,codeValueCode,parentId,projectId
-
action: string
Allowed Values:
[ "DELETE" ]Provide a value for this field during object update to delete code value assigned to the object. -
codeTypeCode: string
Minimum Length:
0Maximum Length:60This field displays the name of a code or value. -
codeTypeId(required): integer
(int64)
The unique identifier for the code type.The code type object can also be identified by its unique criteria.
-
codeValueCode(required): string
Minimum Length:
1Maximum Length:60The unique identifier for the code value. -
codeValueCustomLogId: integer
(int64)
The system-generated identifier of a custom log.
-
codeValueId: integer
(int64)
The unique identifier for the code value.
-
codeValueName: string
Minimum Length:
1Maximum Length:255The name of the code value. -
customLogItemId: integer
(int64)
The system-generated identifier of a document.
-
parentId: integer
(int64)
The unique identifier of a parent code value.
-
projectCode: string
Minimum Length:
1Maximum Length:60The code of a Project of a Project CodeType. -
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
Nested Schema : ApiEntityCustomLogItemConfiguredFieldValueInput
Type:
objectTitle:
ApiEntityCustomLogItemConfiguredFieldValueInputThis entity represents a CustomLogItemConfiguredFieldValue object, a unique CustomLogItemConfiguredFieldValue object can be identified by the following combinations of the fields.
Show Source
- customLogItemConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
-
action: string
Allowed Values:
[ "DELETE" ]Provide value for this field during object update to delete the assigned configured field value. -
columnDefinitionId: integer
(int64)
Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.
-
columnLabel: string
Minimum Length:
1Maximum Length:100The user-specified UDF column label. -
columnName: string
Minimum Length:
1Maximum Length:100The user-specified UDF column name. -
customLogConfiguredFieldValueId: integer
(int64)
The system-generated identifier of a flex field value.
-
customLogItemId: integer
(int64)
The system-generated identifier of a document.
-
dateValue: string
(date-time)
This holds values for Date type configured fields.
-
numberValue: number
This holds values for Number, Integer and Cost type configured fields. Input for the cost configured field should be provided in the currency of record. For example project level currency in case of Activity, base currency for Company, workspace currency for Funds and record level currency for Project Actuals etc. configured fields.
-
textValue: string
Maximum Length:
4000This holds values for Boolean, List and Text type configured fields.
Examples
Back to Top
Response
Supported Media Types
- application/json
201 Response
The object was successfully created.
Root Schema : ApiEntityCustomLogItem
Type:
objectTitle:
Show Source
ApiEntityCustomLogItem-
ballInCourtId: integer
(int64)
The system-generated identifier of a user.
-
ballInCourtUserName: string
Maximum Length:
255The user-specified identifier of the user associated with the object. -
codeValues: array
codeValues
The list of code values for a custom log item. This entity can only be used to assign codeValues or create codeValues on the fly.
-
comment: string
Minimum Length:
0Maximum Length:4000Notes about the custom log item. -
customLogItemCode: string
Minimum Length:
1Maximum Length:60A unique identifier unique of the custom log item. -
customLogItemId: integer
(int64)
The system-generated identifier of a custom log item. This value should not be provided in create operation request data, however, it is required for update requests.
-
customLogsItemName: string
Minimum Length:
0Maximum Length:255The name of the custom log item. -
customLogTypeObjectId: integer
(int64)
The unique identifier for the custom log type object.The custom log type object can also be identified by its unique criteria.
-
customLogTypeObjectName: string
Minimum Length:
0Maximum Length:255The user-specified identifier of a custom log type. -
dueDate: string
(date-time)
The date the custom log item is due.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
postedDate: string
(date-time)
The date the custom log item was added.
-
programCode: string
Maximum Length:
60The unique identifier for a program set by the user who created the program. -
programId: integer
(int64)
A unique identifier of a Program.
-
projectCode: string
Minimum Length:
1Maximum Length:60The user-specified identifier of a project. -
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
status: string
Allowed Values:
[ "DRAFT" ]The status of the custom log item. -
udfValues: array
udfValues
An object containing configured fields in the form of key-value pairs.
-
updateDate: string
(date-time)
Date when the record was last updated.
-
workspaceCode: string
Minimum Length:
0Maximum Length:60The user-specified identifier of a workspace. -
workspaceId: integer
(int64)
The unique identifier of a workspace.
Nested Schema : codeValues
Type:
arrayThe list of code values for a custom log item. This entity can only be used to assign codeValues or create codeValues on the fly.
Show Source
-
Array of:
object ApiEntityCodeValueCustomLog
Title:
ApiEntityCodeValueCustomLog
Nested Schema : udfValues
Type:
arrayAn object containing configured fields in the form of key-value pairs.
Show Source
-
Array of:
object ApiEntityCustomLogItemConfiguredFieldValue
Title:
ApiEntityCustomLogItemConfiguredFieldValue
Nested Schema : ApiEntityCodeValueCustomLog
Type:
objectTitle:
Show Source
ApiEntityCodeValueCustomLog-
action: string
Allowed Values:
[ "DELETE" ]Provide a value for this field during object update to delete code value assigned to the object. -
codeTypeCode: string
Minimum Length:
0Maximum Length:60This field displays the name of a code or value. -
codeTypeId(required): integer
(int64)
The unique identifier for the code type.The code type object can also be identified by its unique criteria.
-
codeTypeName: string
Minimum Length:
0Maximum Length:255The name of a code or value. -
codeValueCode(required): string
Minimum Length:
1Maximum Length:60The unique identifier for the code value. -
codeValueCustomLogId: integer
(int64)
The system-generated identifier of a custom log.
-
codeValueId: integer
(int64)
The unique identifier for the code value.
-
codeValueName: string
Minimum Length:
1Maximum Length:255The name of the code value. -
customLogItemId: integer
(int64)
The system-generated identifier of a document.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
parentId: integer
(int64)
The unique identifier of a parent code value.
-
projectCode: string
Minimum Length:
1Maximum Length:60The code of a Project of a Project CodeType. -
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
sequenceNumber: integer
(int32)
The number that specifies the position of the code value item within the code type list.
-
updateDate: string
(date-time)
Date when the record was last updated.
Nested Schema : ApiEntityCustomLogItemConfiguredFieldValue
Type:
objectTitle:
Show Source
ApiEntityCustomLogItemConfiguredFieldValue-
action: string
Allowed Values:
[ "DELETE" ]Provide value for this field during object update to delete the assigned configured field value. -
columnDefinitionId: integer
(int64)
Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.
-
columnLabel: string
Minimum Length:
1Maximum Length:100The user-specified UDF column label. -
columnName: string
Minimum Length:
1Maximum Length:100The user-specified UDF column name. -
costValue: number
This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record.
-
costValueWorkspace1: number
(double)
This holds values for Cost type configured fields in the workspace1 currency conversion.
-
costValueWorkspace2: number
(double)
This holds values for Cost type configured fields in the workspace2 currency conversion.
-
costValueWorkspace3: number
(double)
This holds values for Cost type configured fields in the workspace3 currency conversion.
-
customLogConfiguredFieldValueId: integer
(int64)
The system-generated identifier of a flex field value.
-
customLogItemId: integer
(int64)
The system-generated identifier of a document.
-
dateValue: string
(date-time)
This holds values for Date type configured fields.
-
exceptionMessage: string
Maximum Length:
4000Provides the error message for why the formula calculation resulted in an error. -
hasException: boolean
Determines if formula calculation hit an error calculating a value for this field.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
numberValue: number
This holds values for Number, Integer and Cost type configured fields. Input for the cost configured field should be provided in the currency of record. For example project level currency in case of Activity, base currency for Company, workspace currency for Funds and record level currency for Project Actuals etc. configured fields.
-
textValue: string
Maximum Length:
4000This holds values for Boolean, List and Text type configured fields. -
updateDate: string
(date-time)
Date when the record was last updated.
400 Response
Invalid Input.