Admin Recovery Endpoints¶

Admin Recovery API endpoints.

Overview¶

Method	Endpoint	Description
GET	`/api/v1/admin/recovery/compute-health`	Get Compute Health
POST	`/api/v1/admin/recovery/heal`	Heal Stuck Tasks

API Reference¶

Sartiq Backend Server - Admin Recovery 0.1.0¶

admin-recovery¶

POST /api/v1/admin/recovery/heal¶

Heal Stuck Tasks

Description

Trigger gentle healing of stuck predictions and refines.

Checks compute server for real task status and only acts on definitive answers (COMPLETED/FAILED). Tasks still running or unreachable are left alone.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`OAuth2PasswordBearer`	header	string	N/A	No

Responses

200 OK

application/json

{
    "predictions_checked": 0,
    "predictions_healed": 0,
    "predictions_failed": 0,
    "predictions_skipped": 0,
    "refines_checked": 0,
    "refines_healed": 0,
    "refines_failed": 0,
    "refines_skipped": 0,
    "errors": [
        "string"
    ],
    "summary": "string"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "predictions_checked": {
            "type": "integer",
            "title": "Predictions Checked",
            "default": 0
        },
        "predictions_healed": {
            "type": "integer",
            "title": "Predictions Healed",
            "default": 0
        },
        "predictions_failed": {
            "type": "integer",
            "title": "Predictions Failed",
            "default": 0
        },
        "predictions_skipped": {
            "type": "integer",
            "title": "Predictions Skipped",
            "default": 0
        },
        "refines_checked": {
            "type": "integer",
            "title": "Refines Checked",
            "default": 0
        },
        "refines_healed": {
            "type": "integer",
            "title": "Refines Healed",
            "default": 0
        },
        "refines_failed": {
            "type": "integer",
            "title": "Refines Failed",
            "default": 0
        },
        "refines_skipped": {
            "type": "integer",
            "title": "Refines Skipped",
            "default": 0
        },
        "errors": {
            "items": {
                "type": "string"
            },
            "type": "array",
            "title": "Errors",
            "default": []
        },
        "summary": {
            "type": "string",
            "title": "Summary",
            "default": ""
        }
    },
    "type": "object",
    "title": "HealingReportResponse",
    "description": "Response from a healing run."
}

GET /api/v1/admin/recovery/compute-health¶

Get Compute Health

Description

Check compute server connectivity and stuck task counts.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`OAuth2PasswordBearer`	header	string	N/A	No

Responses

200 OK

application/json

{
    "connected": true,
    "active_predictions": 0,
    "active_refines": 0,
    "stuck_predictions": 0,
    "stuck_refines": 0,
    "last_heal_at": null,
    "last_heal_summary": null
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "connected": {
            "type": "boolean",
            "title": "Connected"
        },
        "active_predictions": {
            "type": "integer",
            "title": "Active Predictions",
            "default": 0
        },
        "active_refines": {
            "type": "integer",
            "title": "Active Refines",
            "default": 0
        },
        "stuck_predictions": {
            "type": "integer",
            "title": "Stuck Predictions",
            "default": 0
        },
        "stuck_refines": {
            "type": "integer",
            "title": "Stuck Refines",
            "default": 0
        },
        "last_heal_at": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Last Heal At"
        },
        "last_heal_summary": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Last Heal Summary"
        }
    },
    "type": "object",
    "required": [
        "connected"
    ],
    "title": "ComputeServerStatusResponse",
    "description": "Compute server connectivity and healing status."
}

Schemas¶

ComputeServerStatusResponse¶

Name	Type	Description
`active_predictions`	integer
`active_refines`	integer
`connected`	boolean
`last_heal_at`
`last_heal_summary`
`stuck_predictions`	integer
`stuck_refines`	integer

HealingReportResponse¶

Name	Type	Description
`errors`	Array<string>
`predictions_checked`	integer
`predictions_failed`	integer
`predictions_healed`	integer
`predictions_skipped`	integer
`refines_checked`	integer
`refines_failed`	integer
`refines_healed`	integer
`refines_skipped`	integer
`summary`	string

Security schemes¶

Name	Type	Scheme	Description
OAuth2PasswordBearer	oauth2