DOCS / API REFERENCE

List secrets (feed keys)

GET /v1/feed

GETHenHouse API v1

Request

GET /v1/feed

Authenticate with a bearer token. Create one with POST /v1/tokens or cluck login.

Parameters

NameTypeDescription
coop_idstringThe coop to read from
envstringEnvironment 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

IdempotencyThis endpoint is safe to retry. Reads do not lay eggs.