Expand description
Admin REST client for operator-facing endpoints on ff-server.
Wraps POST /v1/admin/* so downstream consumers (cairn-fabric)
don’t hand-roll the HTTP call for admin surfaces like HMAC secret
rotation. Mirrors the server’s wire types exactly — request
bodies and response shapes are defined against
[ff_server::api] + [ff_server::server] and kept 1:1 with the
producer.
Authentication is Bearer token. Callers pick up the token from
wherever they hold it (FF_API_TOKEN env var is the common
pattern, but the SDK does not read env vars on the caller’s
behalf — FlowFabricAdminClient::with_token accepts a
string-like token value (&str or String) via
impl AsRef<str>).
Structs§
- Claim
ForWorker Request - Request body for
POST /v1/workers/{worker_id}/claim. - Claim
ForWorker Response - Response body for
POST /v1/workers/{worker_id}/claim. - Flow
Fabric Admin Client - Client for the
ff-serveradmin REST surface. - Partition
Rotation Outcome - Per-partition outcome of a cluster-wide waitpoint HMAC secret
rotation. Returned by
rotate_waitpoint_hmac_secret_all_partitionsso operators can audit which partitions rotated vs. no-op’d vs. failed. - Rotate
Waitpoint Secret Request - Request body for
POST /v1/admin/rotate-waitpoint-secret. - Rotate
Waitpoint Secret Response - Response body for
POST /v1/admin/rotate-waitpoint-secret.
Functions§
- rotate_
waitpoint_ hmac_ secret_ all_ partitions - Rotate the waitpoint HMAC secret across every execution partition
by fanning out the
ff_rotate_waitpoint_hmac_secretFCALL.