Reference
Admin API
See which Portal routes finoctl uses and how previews and writes are verified.
Connection and permissions
finoctl wholesale uses the Gallo Fino wholesale Portal over HTTPS. Read and write permissions follow the signed-in account’s role. Browser approval creates a session for that CLI environment.
Use the CLI command for the operation you need. Its request command supports GET operations for /api/me, /api/admin/products, and /api/admin/drops.
Routes used by finoctl
| Operation | HTTP route |
|---|---|
| Session status | GET /api/me |
| Sign in and out | POST /api/auth/login, POST /api/auth/logout |
| Browser device flow | POST /api/auth/cli/device/start, POST /api/auth/cli/device/token |
| Product list and search | GET /api/admin/products |
| Product create and edit | POST /api/admin/products, PATCH /api/admin/products/:sku |
| Product archive, restore, and retire | POST /api/admin/products/:sku/archive, POST /api/admin/products/:sku/unarchive, DELETE /api/admin/products/:sku |
| Upload a product photo | POST /api/admin/products/:id/photo |
| Reorder or detach photos | PUT /api/admin/products/:id/images/reorder, DELETE /api/admin/products/:id/images/:sequence |
| Buyer lookup and checkout policy | GET /api/admin/orders/create-options |
| Order list and detail | GET /api/orders, GET /api/orders/:id |
| Order quote and create | POST /api/admin/orders/create |
| Collections and assignment | GET /api/admin/drops, POST /api/admin/products/bulk-move |
| Diagnostics | GET /api/admin/_diag/errors, GET /api/admin/telemetry |
Preview, apply, and reconcile
A saved preview includes the action, request data, operation ID, and before state. Where supported it also includes the saved product revision and file SHA-256. The server checks these when applying. The CLI reads the changed record back to verify persistence.
orders create sends a quote-only request first. Applying the reviewed order uses the same order ID key and the reviewed goods total. Product changes carry an expected revision where relevant. Image operations are tied to the saved product and photo identity.
Read errors
| Response | Meaning |
|---|---|
401 |
Verify the saved session or sign in again. |
403 |
Check the account role for the requested operation. |
409 |
Read the current record and reconcile the conflict. |
503 on diagnostics |
The diagnostics service could not provide results. |
A diagnostic reference identifies a request for investigation. An operation ID identifies an intended write for reconciliation. Preserve both when reporting an interrupted apply.