Skip to main content
PUT
Lock or unlock portal mitigation changes for one application.
string
required
Application-event reference returned by the check.
boolean
required
Use true to lock mitigation changes or false to unlock them.

Lock behavior

The lock covers this application’s mitigation writes and its shared field-year runoff selections. Reads and compliance report downloads remain available. Repeating a lock preserves the original portal_locked_at timestamp; unlocking returns null for that timestamp. Applications sharing the same field/year share runoff selections. A lock on a sibling application can therefore keep those shared runoff writes locked even after this application is unlocked.

Errors

An absent or other-provider application returns 404 APPLICATION_NOT_FOUND. A missing/non-boolean locked value or malformed application UUID returns 422 INVALID_REQUEST. All routes can also return authentication, validation, rate-limit, and dependency errors. Use the error catalog and examples to choose a retry or correction. Keep X-Request-ID when present.