Batch Update Workspaces
put
/primeapi/restapi/workspace/batch
Send a request to this endpoint to update one or more workpsaces.
Request
Supported Media Types
- application/json
One or more workspace objects.
Nested Schema : ApiEntityWorkspace
Type:
Show Source
object
-
description(optional):
string
Summary of the workspace.
-
image(optional):
object ApiEntityWorkspaceImage
-
isProduction(optional):
boolean
Read Only:
true
Indicates a workspace that is in production.
All workspaces created under the Production workspace are automatically designated as production.
This cannot be changed. -
isSysGenerated(optional):
boolean
Read Only:
true
Indicates a workspace that was created by the system.
System generated workspaces cannot be deleted. -
link(optional):
string(url)
Read Only:
true
-
parentWorkspace(optional):
integer(int64)
The unique identifier of the workspace hierarchically above another workspace.
-
securityGuid(optional):
string
The Globally Unique Identifier of the workspace.
-
sequenceNumber(optional):
integer(int32)
Determines the order of appearance of workspaces in a 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. -
workspaceAutonumSettings(optional):
array workspaceAutonumSettings
Unique Items Required:
true
An object containing workspace autonumber settings. -
workspaceCode(optional):
string
Workspace Code.
-
workspaceId(optional):
integer(int64)
The unique identifier of a workspace.
-
workspaceName(optional):
string
Name of a workspace.
-
workspaceSettings(optional):
array workspaceSettings
Unique Items Required:
true
An object containing workspace settings.
Nested Schema : ApiEntityWorkspaceImage
Type:
Show Source
object
-
image(optional):
array image
An image object represented in binary format.
-
imageType:
string
Allowed Values:
[ "PNG", "JPEG", "GIF" ]
The file type of the image. Valid values are PNG, JPEG, and GIF. -
link(optional):
string(url)
Read Only:
true
-
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. -
workspaceId:
integer(int64)
The unique identifier of the workspace that contains this image.
-
workspaceImageId:
integer(int64)
The unique identifier of the image.
Nested Schema : workspaceAutonumSettings
Type:
array
Unique Items Required:
true
An object containing workspace autonumber settings.
Show Source
Nested Schema : workspaceSettings
Type:
array
Unique Items Required:
true
An object containing workspace settings.
Show Source
Nested Schema : ApiEntityWorkspaceAutonumSetting
Type:
Show Source
object
-
area(optional):
string
Allowed Values:
[ "IDEA", "ACTIVITY", "ACTIVITY_ASSIGNMENT", "SCOPE_ITEM", "SCOPE_ASSIGNMENT", "CHANGE_ITEM", "WORK_PACKAGE", "CHANGE_REQUEST", "CONTRACT", "COMMITMENT", "BUDGET_CHANGE", "BUDGET_TRANSFER", "CHANGE_ORDER", "POTENTIAL_CHANGE_ORDER", "PAYMENT_APPLICATION", "RISK", "ACTUALS", "WORK_MANAGER_TASK", "SUBMITTAL", "CHANGE_EVENT", "RFI", "CUSTOM_LOGS_ITEM" ]
Identifies the type of object used for auto numbering. -
autonumId(optional):
integer(int64)
The unique identifier of an auto numbering sequence.
-
link(optional):
string(url)
Read Only:
true
-
name(optional):
string
Name of the auto numbering sequence.
-
prefix(optional):
string
Initial characters for the workspace auto numbering sequence.
-
suffix(optional):
string
The first number in the workspace auto numbering sequence.
-
suffixIncrement(optional):
integer(int32)
Number by which the auto numbering suffix is incremented.
-
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. -
workspaceId(optional):
integer(int64)
The unique identifier of a workspace.
Nested Schema : ApiEntityWorkspaceSetting
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
settingName:
string
Name of a workspace setting.
-
settingValue:
string
Value of a workspace setting.
-
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. -
workspaceId:
integer(int64)
The unique identifier of a workspace setting.
-
workspaceSettingId:
integer(int64)
The unique identifier of a workspace setting.
Response
Supported Media Types
- application/json
200 Response
A collection of object IDs mapped to a canonical link of the object. For example - {"links":{"1":"https://:/primeapi/restapi/
400 Response
Invalid input.