---
title: "Reconcile the latest DuckLake maintenance attempt from K8s job status"
method: POST
path: "/v4/automations/jobs/{job_id}/maintenance/sync"
tags: ["v4", "Automations"]
---

# Reconcile the latest DuckLake maintenance attempt from K8s job status

`POST /v4/automations/jobs/{job_id}/maintenance/sync`

## Request

- Base URL: `https://api.definite.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.definite.app/v4/automations/jobs/{job_id}/maintenance/sync`
- Auth: none declared
- TypeScript: <https://skmtc.dev/definite/apis/defapi/docs/v4/automations/jobs/:job_id/maintenance/sync/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `job_id` union, required
  - string, uuid
  - string

## Response `200`

Success

- SuccessResponseDuckLakeMaintenanceAttemptSyncResponse
  - `success` true, required: Flag for it request was successful
  - `data` DuckLakeMaintenanceAttemptSyncResponse, required
    - `attemptId` integer, nullable: Reconciled automation run attempt id, if one exists
    - `attemptStatus` 'running' | 'success' | 'failure' | 'expired', nullable: Attempt status after reconciliation (unchanged when not reconciled)
    - `verdictOutcome` string, required: Prior maintenance verdict: in_flight, terminal, failed, not_current, status_unavailable, no_maintenance_attempt, or integration_not_found
    - `maintenanceId` string, nullable: DuckLake maintenance run id from the attempt metadata
    - `jobStatus` 'pending' | 'running' | 'succeeded' | 'failed' | 'unknown', nullable: K8s maintenance job status from the verdict, when available
    - `reconciled` boolean: Whether the attempt row was updated in the database
  - `meta` ResponseMeta
    - `requestId` string: Unique request identifier for tracing
    - `timestamp` string, date-time: Response timestamp (UTC)
    - `durationMs` integer, nullable: Request processing time in milliseconds

## Other responses

- `401`: Auth Invalid Token
- `403`: Forbidden Insufficient Permissions
- `404`: Resource Not Found
- `422`: Validation Failed
- `426`: Business Quota Exceeded
- `500`: Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) - [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) - [OpenAPI document](https://skmtc.dev/definite/apis/defapi/revisions/5ea378187147?raw)