Deactivate (archive) a region
Soft-archives a region by flipping its active flag to false — never a physical delete (historic stores still reference the region label), so it still reads back as inactive and can be reactivated with an update. Idempotent: deactivating an already-inactive region is a no-op that returns it unchanged. 404s for an unknown region. PERMISSION TRAP (see solya-pos#950): the route guard accepts pos.settings.manage, but the use-case additionally asserts the kernel config:manage permission and NO pos.settings.* scope maps to it, so a principal authenticated by scopes alone clears the guard and then 403s inside the use-case.
Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Path Parameters
1Response
The archived region directory record (active: false).

