Assets API
POST/api/v1/asset-groups
Product availabilityAlgaPSA

Create an asset group

Creates a bundle or shared workspace for a client, optionally with its first members. Adding a member to a bundle assigns it to the owner and moves it to the group location; adding one to a shared workspace unassigns it.

RBAC · asset

Request body

Content type: application/json · schema CreateAssetGroupRequest

client_idstring <uuid>Required
namestringRequired
max length 255
kindstringRequired
Enum: bundleshared_workspace
location_idstring <uuid>Nullable
descriptionstringNullable
asset_idsarray of string
Members to add in the same transaction.
itemsstring <uuid>

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 created successfully.
400
Validation failed, or a group invariant was violated (client mismatch, asset already grouped).
401
x-api-key is missing at middleware.
403
Caller lacks asset update permission.
500
Unexpected error.