descriptionstring | null
Optional description of the group.
namestringrequired
Name of the group. Must be unique within the account. Must be a string (numbers are not coerced).
Create a group
Creates a new group.
Requires the GROUPMANAGEMENT security role.
post
https://{your-bynder-domain}/api/1/groups
Body
application/json
Body
application/json
Response
application/json
Response
application/json
Group created successfully.
Group
descriptionstring | null
idstring(uuid)
namestring
user_countinteger
Number of members in the group.
post/api/1/groups
Authentication
Body
{
"name": "name"
}
application/json
Delete a group
Deletes a group and removes all its members from it.
Requires the GROUPMANAGEMENT security role.
delete
https://{your-bynder-domain}/api/1/groups/{groupId}
Path Parameters
groupIdstring(uuid)required
ID of the group to delete (hyphens optional).
Response
Response
Group deleted successfully. No content is returned.
delete/api/1/groups/{groupId}
Authentication
Path Parameters
Get group by ID
Returns a single group by its ID, including member count.
Requires the GROUPMANAGEMENT security role.
get
https://{your-bynder-domain}/api/1/groups/{groupId}
Path Parameters
groupIdstring(uuid)required
ID of the group (hyphens optional).
Response
application/json
Response
application/json
Successful response
Group
descriptionstring | null
idstring(uuid)
namestring
user_countinteger
Number of members in the group.
get/api/1/groups/{groupId}
Authentication
Path Parameters
application/json
Update a group
Updates the name and/or description of an existing group.
At least one field must be provided. Only the fields included in the request body are updated
(partial update semantics).
Requires the GROUPMANAGEMENT security role.
patch
https://{your-bynder-domain}/api/1/groups/{groupId}
Path Parameters
groupIdstring(uuid)required
ID of the group to update (hyphens optional).
Body
application/json
Body
application/json
descriptionstring | null
New description for the group. Pass null to clear it.
namestring
New name for the group. Must be unique within the account.
Response
application/json
Response
application/json
Group updated successfully.
Group
descriptionstring | null
idstring(uuid)
namestring
user_countinteger
Number of members in the group.
patch/api/1/groups/{groupId}
Authentication
Path Parameters
Body
{}
application/json
Add users to a group
Adds one or more users to the specified group. Pass a single-element array to add one user.
Users that are already members of the group are silently ignored (the operation is idempotent).
An empty user_ids array is accepted and is a no-op.
Requires the GROUPMANAGEMENT security role.
post
https://{your-bynder-domain}/api/1/groups/{groupId}/add-users
Path Parameters
groupIdstring(uuid)required
ID of the group (hyphens optional).
Body
application/json
Body
application/json
GroupMembersInput
user_idsarray[string](uuid)required
IDs of the users to add or remove. An empty list is a no-op.
Response
application/json
Response
application/json
Users added successfully.
GroupMembersResult
user_countinteger
Updated number of members in the group after the operation.
post/api/1/groups/{groupId}/add-users
Authentication
Path Parameters
Body
{
"user_ids": []
}
application/json