Bulk adjust group bucket membership
Bulk Adjust Group Bucket Membership using the API key’s account.
POST
/api/v1/privacy-buckets/bulk/groupsprivacyBuckets: read_write1,000 requests/minute/key · all plansActive API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.
Parameters
No path or query parameters.
Request body
application/json · required
Unknown properties are rejected.
| Name | Type | Required | Description |
|---|---|---|---|
bucketId | string (uuid) | Required | Bucket Id. |
mode | string | Required | Mode. Allowed values: "add", "remove". |
friendUserIds | array<string (uuid)> | Optional | Friend User Ids. At least 1 items. At most 250 items. |
memberIds | array<string (uuid)> | Optional | Associated member identifiers. At least 1 items. At most 250 items. |
groupIds | array<string (uuid)> | Optional | Group Ids. At least 1 items. At most 250 items. |
directoryIds | array<string (uuid)> | Optional | Directory Ids. At least 1 items. At most 250 items. |
Response schema
204
Successful operation. No response body.
Errors
400· JSON errorRequest failed (BAD_REQUEST).
401· JSON errorMissing or invalid API key. Use Authorization: Bearer <token>.
403· JSON errorRequires privacyBuckets: read_write; ownership or feature restrictions may also deny access.
404· JSON errorRequest failed (NOT_FOUND).
409· JSON errorRequest failed (CONFLICT).
429· JSON errorAPI rate limit exceeded (1000 requests per minute). Retry shortly.
Request example
Set FLORALITY_KEY in your environment. These examples use demo identifiers.
curl --request POST 'https://floralitys.com/api/v1/privacy-buckets/bulk/groups' \
--header "Authorization: Bearer $FLORALITY_KEY" \
--header "Content-Type: application/json" \
--data '{
"bucketId": "11111111-1111-4111-8111-111111111111",
"mode": "add"
}'Responses
Successful operation. No response body.
No response body.
Example values are illustrative demo data.