Request
PUT /v1/flocks/{flock_id}/members
Authenticate with a bearer token. Create one with POST /v1/tokens or cluck login.
Parameters
| Name | Type | Description |
|---|---|---|
flock_id | string | The flock ID (path) |
members | array | List of user IDs |
Example
curl -X PUT https://api.pollosoft.example/v1/flocks/flock_8f2a/members \
-H "Authorization: Bearer $COOP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"members": []}'
Response
A successful call returns 200 OK with JSON like this:
{
"id": "flk_31aa",
"members": 6,
"updated": true
}
Errors
HEN-2001(401): Not logged inHEN-2004(403): Insufficient pecking orderHEN-5001(429): Too many pecksHEN-3001(404): Coop not foundHEN-1002(400): Missing required field
IdempotencySend an
Idempotency-Key header to make retries safe. We will return the original result instead of laying a second egg.