The HenHouse API is a JSON REST API at https://api.pollosoft.example. All requests require a bearer token, all timestamps are ISO 8601 in UTC, and all errors use the HEN-xxxx format.
curl https://api.pollosoft.example/v1/coops \
-H "Authorization: Bearer $COOP_TOKEN"GET
GET /v1/coops
List coops
POST
POST /v1/coops
Create a coop
GET
GET /v1/coops/{coop_id}
Retrieve a coop
DELETE
DELETE /v1/coops/{coop_id}
Delete a coop
GET
GET /v1/hens
List hens (instances)
POST
POST /v1/hens/{hen_id}/restart
Restart a hen
GET
GET /v1/flocks
List flocks (teams)
POST
POST /v1/flocks
Create a flock
PUT
PUT /v1/flocks/{flock_id}/members
Replace flock members
GET
GET /v1/deployments
List deployments
POST
POST /v1/deployments
Create a deployment
POST
POST /v1/deployments/{deployment_id}/rollback
Roll back a deployment
GET
GET /v1/eggs
List eggs (build artifacts)
POST
POST /v1/eggs
Publish an egg
GET
GET /v1/feed
List secrets (feed keys)
PUT
PUT /v1/feed/{key}
Set a secret
POST
POST /v1/feed/{key}/rotate
Rotate a secret
GET
GET /v1/fences
List firewall rules
POST
POST /v1/fences
Create a firewall rule
GET
GET /v1/foxes
List security findings
POST
POST /v1/foxes/{finding_id}/resolve
Resolve a finding
GET
GET /v1/nests
List containers (nests)
POST
POST /v1/nests
Run a container
GET
GET /v1/metrics/query
Query metrics
GET
GET /v1/logs
Search logs
POST
POST /v1/webhooks
Create a webhook
GET
GET /v1/webhooks/{webhook_id}/deliveries
List webhook deliveries
POST
POST /v1/tokens
Create an API token
DELETE
DELETE /v1/tokens/{token_id}
Revoke an API token
GET
GET /v1/regions
List regions
GET
GET /v1/invoices
List invoices
GET
GET /v1/usage
Get usage by service
POST
POST /v1/perches/deploy
Deploy to edge perches