Assets API
PUT/api/v1/asset-groups/{id}
Product availabilityAlgaPSA

Update an asset group

Renames the group, changes its kind or moves its location. A location change moves every member. shared_workspace to bundle is refused while users exist; bundle to shared_workspace unassigns every member and drops the owner.

RBAC · asset

Path parameters

idstring <uuid>Required
asset_groups.group_id

Request body

Content type: application/json · schema UpdateAssetGroupRequest

namestring
max length 255
kindstring
shared_workspace to bundle is refused while users exist; the reverse unassigns every member.
Enum: bundleshared_workspace
location_idstring <uuid>Nullable
Propagates to every member.
descriptionstringNullable

Response body

Success response 200 · schema AssetGroupResponse

dataobjectRequired
group_idstring <uuid>Required
client_idstring <uuid>Required
namestringRequired
kindstringRequired
A bundle has one owner and moves as a unit; a shared workspace has users and its members carry no single assignee.
Enum: bundleshared_workspace
location_idstring <uuid>Nullable
location_namestringNullable
descriptionstringNullable
member_countinteger
people_countinteger
membersarray of object
itemsobject
asset_idstring <uuid>Required
asset_namestringNullable
asset_typestringNullable
asset_tagstringNullable
asset_statusstringNullable
contactsarray of object
itemsobject
contact_name_idstring <uuid>Required
contact_namestringNullable
rolestringRequired
Enum: owneruser

Response codes

200
Asset group updated successfully.
400
Validation failed or a group invariant was violated.
401
x-api-key is missing at middleware.
403
Caller lacks asset update permission.
500
Unexpected error.