Request
GET /v1/feed
Authenticate with a bearer token. Create one with POST /v1/tokens or cluck login.
Parameters
| Name | Type | Description |
|---|---|---|
coop_id | string | The coop to read from |
env | string | Environment filter |
Example
curl -X GET https://api.pollosoft.example/v1/feed?coop_id=example&env=example \
-H "Authorization: Bearer $COOP_TOKEN"
Response
A successful call returns 200 OK with JSON like this:
{
"data": [
{
"key": "DB_URL",
"env": "production",
"version": 7,
"rotated_at": "2026-10-01T04:00:00Z"
}
],
"has_more": false
}
Errors
HEN-2001(401): Not logged inHEN-2004(403): Insufficient pecking orderHEN-5001(429): Too many pecks
IdempotencyThis endpoint is safe to retry. Reads do not lay eggs.