DOCS / API REFERENCE

Set a secret

PUT /v1/feed/{key}

PUTHenHouse API v1

Request

PUT /v1/feed/{key}

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

Parameters

NameTypeDescription
keystringThe secret name (path)
valuestringThe secret value (never logged)
envstringEnvironment

Example

curl -X PUT https://api.pollosoft.example/v1/feed/key_8f2a \
  -H "Authorization: Bearer $COOP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"value": "example-value", "env": "example-env"}'

Response

A successful call returns 200 OK with JSON like this:

{
  "key": "DB_URL",
  "version": 8,
  "stored": true
}

Errors

IdempotencySend an Idempotency-Key header to make retries safe. We will return the original result instead of laying a second egg.