Resolve a reconciliation finding

Resolves one finding through the existing Work-domain reconciliation policy. Approved entries remain protected from mutation.

POST/api/v1/time-reconciliation-findings/:id/resolve

Authorization

time:reconcileapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Finding ID

Example: finding_01k2...

Request body

resolution_actionstringrequired"dismiss" | "reviewed_keep_both" | "prefer_timely" | "prefer_ds_native"

Governed resolution command

confirmbooleanrequired

Must be true

Example request

{
  "resolution_action": "prefer_ds_native",
  "confirm": true
}

Request

POST /api/v1/time-reconciliation-findings/:id/resolve

curl -X POST "https://www.digitalstack360.com/api/v1/time-reconciliation-findings/finding_01k2.../resolve" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resolution_action":"prefer_ds_native","confirm":true}'

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "id": "finding_01k2...",
    "state": "resolved",
    "resolution_action": "prefer_ds_native",
    "entries_updated": 0
  },
  "meta": {
    "admin_only": true
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

400

bad_request

Missing or invalid request fields

403

scope_insufficient

Key lacks the required write scope

403

admin_required

Workspace admin or owner role is required

423

approved_entry_locked

Resolution cannot mutate an approved entry