Get recurring R2 maintenance status and storage metrics.

GET

/api/admin/jobs/schedules

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/api/admin/jobs/schedules \
  --header 'Authorization: Bearer <token>'

Platform administrator only. Returns whether each R2 maintenance task is enabled, its cron expression, durable previous execution evidence, computed next execution time, and the latest bounded fleet-wide per-bucket storage metric scan aggregated by Control. Each owning Worker reports only a secret-free summary; pending and stale reports are explicit. Error codes and object metadata are redacted from sensitive payload content.

Authorizations

• adminBearer
• adminSessionCookie

Responses

200

Scheduled maintenance status and latest R2 metrics.

Media type application/json

object

schedules

required

Array<object>

object

id

required

string

name

required

string

enabled

required

boolean

cron

required

string

status

required

string

Allowed values: never_run running succeeded failed disabled

lastStartedAt

integer | null

lastCompletedAt

integer | null

nextRunAt

integer | null

lastErrorCode

string | null

storageMetrics

required

Array<object>

object

binding

required

string

Allowed values: MIGRATION_RELEASES PLUGIN_BUNDLES PUBLIC_ASSETS DIAGNOSTIC_LOGS AUDIT_ARCHIVE IMPORT_ARTIFACTS EXPORT_ARTIFACTS SENSITIVE_DETAILS

ownerWorker

required

string

Allowed values: ar-control ar-management ar-plugin-runner

availability

required

string

Allowed values: current stale pending

unavailableReason

required

string | null

reportedAt

required

integer | null

objectCount

required

integer

totalBytes

required

integer

oldestObjectAt

integer | null

encryptionMethods

required

object

key

additional properties

integer

retentionOverdueObjects

integer | null

retentionPolicy

required

string

scanComplete

required

boolean

measuredAt

required

integer

Example

{
  "schedules": [
    {
      "status": "never_run"
    }
  ],
  "storageMetrics": [
    {
      "binding": "MIGRATION_RELEASES",
      "ownerWorker": "ar-control",
      "availability": "current"
    }
  ]
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}