Request
DELETE /v1/coops/{coop_id}Authenticate with a bearer token. Create one with POST /v1/tokens or cluck login.
Parameters
| Name | Type | Description |
|---|---|---|
coop_id | string | The coop ID (path) |
confirm | string | Must equal the coop name |
Example
curl -X DELETE https://api.pollosoft.example/v1/coops/coop_8f2a?confirm=example \
-H "Authorization: Bearer $COOP_TOKEN"Response
A successful call returns 200 OK with JSON like this:
{
"id": "coop_8f2a",
"deleted": true
}Errors
HEN-2001(401): Not logged inHEN-2004(403): Insufficient pecking orderHEN-5001(429): Too many pecksHEN-3001(404): Coop not found
IdempotencyThis endpoint is safe to retry. Reads do not lay eggs.