API: ops
GET /api/v1/ops/image-references
Section titled “GET /api/v1/ops/image-references”Get Image References
Image URLs referenced by articles + plan-vs-generated gaps.
Feed for the image-generation usage reconciler.
Auth: Authorization: Bearer <token> required
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
sc_id | query | no | integer | null | |
page | query | no | integer | |
page_size | query | no | integer |
Responses:
| Code | Meaning | Body |
|---|---|---|
200 | Successful Response | ImageReferencesPage |
401 | Missing or invalid authentication credentials | ErrorResponse |
422 | Validation Error | HTTPValidationError |
POST /api/v1/ops/orchestrator/heartbeat
Section titled “POST /api/v1/ops/orchestrator/heartbeat”Post Orchestrator Heartbeat
Record the gen-orchestrator’s per-tick heartbeat (targets/active/note).
Auth: Authorization: Bearer <token> required
| Parameter | In | Required | Type | Description |
|---|---|---|---|---|
Idempotency-Key | header | no | string | Optional. |
Request body: application/json — schema OrchestratorHeartbeatIn
| Field | Type | Required | Description |
|---|---|---|---|
active | object | null | no | |
note | string | null | no | |
targets | object | null | no | |
tick_s | integer | null | no |
Responses:
| Code | Meaning | Body |
|---|---|---|
204 | Successful Response | — |
401 | Missing or invalid authentication credentials | ErrorResponse |
422 | Validation Error | HTTPValidationError |
GET /api/v1/ops/overview
Section titled “GET /api/v1/ops/overview”Get Overview
Live platform ops snapshot — poll this (3-5s) to watch the whole platform.
Auth: Authorization: Bearer <token> required
Responses:
| Code | Meaning | Body |
|---|---|---|
200 | Successful Response | OpsOverview |
401 | Missing or invalid authentication credentials | ErrorResponse |