Update a Submittal
put
/primeapi/restapi/submittal
Send a request to this endpoint to update a submittal. An application object with an ID value that matches the ID value provided in the JSON object in the request body will be updated to reflect the JSON contents.
Request
Supported Media Types
- application/json
A submittal object.
Root Schema : ApiEntitySubmittal
Type:
Show Source
object
-
approvalComment(optional):
string
Additional information about the submittal.
-
approvedDate(optional):
object TimezoneSensitiveDateTime
-
approvingCompanyId(optional):
integer(int64)
Read Only:
true
The company related to the user who approved the submittal. -
approvingCompanyName(optional):
string
Read Only:
true
Name of the approvedBy Company that has to be assigned to the project and Submittals. -
approvingCompanyPostalCode(optional):
string
Read Only:
true
PostalCode of the approvedBy Company that has to be assigned to the project and Submittals. -
approvingUserId(optional):
integer(int64)
Read Only:
true
The user who will approve the submittal. -
approvingUserName(optional):
string
UserName of the approvedBy user, that has to be assigned to submittal.
-
ballInCourtId(optional):
integer(int64)
Read Only:
true
The user who is responsible for the submittal. -
codeValues(optional):
array codeValues
Unique Items Required:
true
The categories assigned to a submittal. -
coordinatingCompanyId(optional):
integer(int64)
The company associated with the user who is responsible for reviewing detailed work documents.
-
coordinatingCompanyName(optional):
string
Name of the coordinating Company that has to be assigned to the project and Submittals.
-
coordinatingCompanyPostalCode(optional):
string
PostalCode of the coordinating Company that has to be assigned to the project and Submittals.
-
coordinatingUserId(optional):
integer(int64)
The user who is responsible for reviewing detailed work documents.
-
coordinatingUserName(optional):
string
UserName of the coordinating user, that has to be assigned to submittal.
-
dateCreated(optional):
object TimezoneSensitiveDateTime
-
description(optional):
string
Detailed information about the submittal.
-
dueDate(optional):
string(date-time)
The date by which the submittal must be approved.
-
dueDateChanged(optional):
boolean
Read Only:
true
Indicates whether or not the due date changed. -
flowType(optional):
string
The flow type of a submittal.
-
isCustomWorkflowInProgress(optional):
boolean
Read Only:
true
Indicates whether or not a custom workflow is in progress on the submittal. -
isProjectCompanyExists(optional):
boolean
Read Only:
true
Indicates whether or not an assocaited project company exists. -
itemCode(optional):
string
A unique identifier for the submittal.
-
itemPrefix(optional):
string
The prefix of the unique identifier of a submittal.
-
itemSuffix(optional):
integer(int64)
The suffix of the unique identifier of a submittal.
-
link(optional):
string(url)
Read Only:
true
-
materialDeliveryDate(optional):
string(date-time)
The date by which materials must be delivered.
-
priority(optional):
string
Allowed Values:
[ "HIGH", "MEDIUM", "NORMAL", "LOW" ]
The submittal's level of importance. Priority can be set to High, Medium, Normal, or Low. -
projectCode(optional):
string
Project Code of the project, which the Submittal is part of.
-
projectId:
integer(int64)
The system-generated identifier of a project.
-
requiredAction(optional):
string
Allowed Values:
[ "SUBMIT", "REVIEW", "ASSIGN", "FINAL_REVIEW", "NONE", "SUBMIT_REVISION", "RESUBMIT", "SET_AS_DRAFT", "REQUEST_REVISION", "REJECTED" ]
Indicates whether the submittal requires an action from a user. -
reviewedBy(optional):
string
The user who officially approved the submittal.
-
revisionNo(optional):
string
Read Only:
true
This number is automatically generated and based on values in the submittal's Revision fields. -
sendNotification(optional):
boolean
Indicates whether or not changes to the submittal distribute notifications.
-
specSectionId:
integer(int64)
The spec section's ID and title.
-
specSectionNumber(optional):
string
SpecSectionNumber of the spec section, which submittal is part of.
-
status(optional):
string
Allowed Values:
[ "DRAFT", "PENDING_REVIEW", "PENDING_APPROVAL", "REJECTED", "APPROVED", "APPROVED_AS_NOTED", "REVISION_NEEDED", "CANCELED" ]
The status of the submittal. Available Status values include Draft, Pending Review, Pending Approval, Revision Needed, Rejected, Approved, Approved as Noted, and Canceled. -
submitByDate(optional):
string(date-time)
Read Only:
true
The date when the submittal is due by the subcontractor. -
submitByDateChanged(optional):
boolean
Read Only:
true
Indicates whether or not the submit by date has changed. -
submittalConfiguredFields(optional):
object ApiEntitySubmittalConfiguredFields
-
submittalId(optional):
integer(int64)
A unique identifier for the submittal.
-
submittalName:
string
The name of the submittal.
-
submittingCompanyId(optional):
integer(int64)
The company associated with the user who is responsible for uploading the submittal document.
-
submittingCompanyName(optional):
string
Read Only:
true
Name of the submitting Company that has to be assigned to the project and Submittals. -
submittingCompanyPostalCode(optional):
string
PostalCode of the submitting Company that has to be assigned to the project and Submittals.
-
submittingUserId(optional):
integer(int64)
The user who is responsible for uploading the submittal document.
-
submittingUserName(optional):
string
The username of the user that submitted the submittal.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspaceCode(optional):
string
Workspace Code of the workspace, which the project containing the Submittal is part of.
Nested Schema : codeValues
Type:
array
Unique Items Required:
true
The categories assigned to a submittal.
Show Source
Nested Schema : ApiEntitySubmittalConfiguredFields
Type:
Show Source
object
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesCost fields assigned to the Submittal with its corresponding value as a (key,value) pair.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesOther fields assigned to the Submittal with its corresponding value as a (key,value) pair.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesText fields assigned to the Submittal with its corresponding value as a (key,value) pair.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityCodeValueSubmittal
Type:
Show Source
object
-
codeType(optional):
object ApiEntityCodeType
-
codeValue(optional):
object ApiEntityCodeValue
-
codeValueSubmittalId(optional):
integer(int64)
The system-generated identifier of a submittal.
-
link(optional):
string(url)
Read Only:
true
-
submittalId(optional):
integer(int64)
The system-generated identifier of a submittal.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityCodeType
Type:
Show Source
object
-
assignments(optional):
array assignments
Unique Items Required:
true
CodeType assignments. -
codeTypeCode:
string
Allowed Values:
[ "Length[1-40]" ]
This field displays the name of a code or value. -
codeTypeId(optional):
integer(int64)
The system-generated identifier of a code type.
-
codeTypeName:
string
Allowed Values:
[ "Length[1-40]" ]
The name of a code or value. -
link(optional):
string(url)
Read Only:
true
-
pushDownType:
string
Allowed Values:
[ "MANUAL", "AUTOMATIC" ]
The push down type of the workspace code. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspace:
integer(int64)
The ID of the owning workspace.
Nested Schema : ApiEntityCodeValue
Type:
Show Source
object
-
codeTypeId:
integer(int64)
The ID for the code type.
-
codeTypeName:
string
The name of a code or value.
-
codeValueCode:
string
Allowed Values:
[ "LENGTH[1-32]" ]
The unique identifier for the code value. -
codeValueId(optional):
integer(int64)
The unique identifier for the code value.
-
codeValueName:
string
Allowed Values:
[ "LENGTH[1-100]" ]
The name of the code value. -
link(optional):
string(url)
Read Only:
true
-
parentCodeValue(optional):
integer(int64)
The parent code value.
-
sequenceNumber:
integer(int32)
The number that specifies the position of the code value item within the code type list.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : assignments
Type:
array
Unique Items Required:
true
CodeType assignments.
Show Source
Nested Schema : ApiEntityCodeEntityType
Type:
Show Source
object
-
codeType:
object ApiEntityCodeType
-
entityType:
string
Allowed Values:
[ "SCOPE_ITEM", "PROJECT", "SCOPE_ASSIGNMENT", "WBS", "WORK_PACKAGE", "ACTIVITY", "RESOURCE", "PBS", "CONTRACT", "RISK", "COMMITMENT", "REPORT", "TASKS", "STRATEGY", "PORTFOLIO", "FUND", "SUBMITTAL", "CHANGE_ORDER", "PAYMENT_APPLICATION", "CHANGE_EVENT", "CHANGES_ESTIMATES", "IDEA", "RFI", "CUSTOM_LOG_ITEM" ]
Indicates the type of object the code is associated to. -
link(optional):
string(url)
Read Only:
true
-
primaryKey:
integer(int64)
The unique identifier of a code type table.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : costFlexMap
Type:
object
Additional Properties Allowed
Show Source
Cost fields assigned to the Submittal with its corresponding value as a (key,value) pair.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
Other fields assigned to the Submittal with its corresponding value as a (key,value) pair.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
Text fields assigned to the Submittal with its corresponding value as a (key,value) pair.
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Response
Supported Media Types
- application/json
204 Response
Successful operation with no content.
400 Response
Invalid Input.