List stale file deployments

GET 
/api/file/stale

Returns deployments where the source object in the Object Store has been updated since the file was last deployed. Controller-only check that compares state KV SHA-256 hashes against current object content.

Responses

200

Stale deployments found (may be empty).

application/json

Schema

Schema

stale

object[]

required

Array [

object_name stringrequired

Name of the object in the Object Store.

hostname stringrequired

Host where the file is deployed.

provider stringrequired

Provider that manages this deployment.

path stringrequired

Deployment path on the target host.

deployed_sha stringrequired

SHA-256 hash of the currently deployed content.

current_sha stringrequired

SHA-256 hash of the current object store content.

deployed_at stringrequired

When the file was last deployed.

]

total integerrequired

Total number of stale deployments.

Example (from schema)

{
  "stale": [
    {
      "object_name": "hello-echo",
      "hostname": "web-01",
      "provider": "service",
      "path": "/etc/systemd/system/osapi-hello-echo.service",
      "deployed_sha": "abc123def456",
      "current_sha": "789abc012def",
      "deployed_at": "2026-04-01T18:00:00Z"
    }
  ],
  "total": 0
}

401

Unauthorized - API key required.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

403

Forbidden - Insufficient permissions.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

500

Internal server error.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

Loading...