{"schemaVersion":"1.0","sourceCommit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca","sourceVisibility":"private","article":{"id":"api-client-mansoq-hmis-web-src-components-location-utils-locationhelpers-ts","title":"Location Helpers client API reference · mansoq-hmis-web","summary":"5 client route/call declarations with path parameters, named payload/response types and source references. Exact server acceptance and permissions require the matched backend contract.","module":"IT & integrations","roles":["IT administrator","Developer","Integration engineer"],"facilities":["All configured facility types"],"kind":"reference","minutes":3,"prerequisites":["Use the API contract from the installed deployment and an authorized synthetic test environment.","Confirm facility/organization scope, action permissions and optional app enablement.","This reference is static source evidence; complete payload, authorization, failure and end-to-end review remains recorded as pending."],"steps":[],"sections":[{"title":"Client contract scope","body":"These 5 declarations come from **repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts**. Client types and noAuth flags describe the caller; they do not authorize a server action. Dynamic paths and missing backend matches are retained as review work, not repaired into invented endpoints."},{"title":"Operation map","body":"| Client method | HTTP method | Path pattern | Resolution |\n| --- | --- | --- | --- |\n| anonymous | UNRESOLVED | `/api/v1/facility/{facilityId}/location/{location.location.id}/association/{location.id}/` | template; runtime values required |\n| anonymous | UNRESOLVED | `/api/v1/facility/{facilityId}/location/{bedId}/association/` | template; runtime values required |\n| anonymous | UNRESOLVED | `/api/v1/facility/{facilityId}/location/{location.id}/` | template; runtime values required |\n| anonymous | UNRESOLVED | `/api/v1/facility/{facilityId}/location/{location.location.id}/association/{location.id}/` | template; runtime values required |\n| anonymous | UNRESOLVED | `/api/v1/facility/{facilityId}/location/{locationId}/association/{associationId}/` | template; runtime values required |"},{"title":"anonymous","body":"**UNRESOLVED /api/v1/facility/{facilityId}/location/{location.location.id}/association/{location.id}/**. HTTP option object; client/server ownership review pending; template; runtime values required. no exact statically resolved backend match in scanned contracts.\n\n**Path parameters:** `facilityId`, `location.location.id`, `location.id`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"anonymous","body":"**UNRESOLVED /api/v1/facility/{facilityId}/location/{bedId}/association/**. HTTP option object; client/server ownership review pending; template; runtime values required. no exact statically resolved backend match in scanned contracts.\n\n**Path parameters:** `facilityId`, `bedId`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"anonymous","body":"**UNRESOLVED /api/v1/facility/{facilityId}/location/{location.id}/**. HTTP option object; client/server ownership review pending; template; runtime values required. no exact statically resolved backend match in scanned contracts.\n\n**Path parameters:** `facilityId`, `location.id`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"anonymous","body":"**UNRESOLVED /api/v1/facility/{facilityId}/location/{location.location.id}/association/{location.id}/**. HTTP option object; client/server ownership review pending; template; runtime values required. no exact statically resolved backend match in scanned contracts.\n\n**Path parameters:** `facilityId`, `location.location.id`, `location.id`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."},{"title":"anonymous","body":"**UNRESOLVED /api/v1/facility/{facilityId}/location/{locationId}/association/{associationId}/**. HTTP option object; client/server ownership review pending; template; runtime values required. no exact statically resolved backend match in scanned contracts.\n\n**Path parameters:** `facilityId`, `locationId`, `associationId`. Transport strings are declared here; semantic identifier types require the server contract.\n\n**Operational limitation:** request validation, permission checks, error statuses and irreversible side effects belong to the server implementation. An unmatched or computed client route requires contract review before use."}],"troubleshooting":[{"problem":"A declared route is unavailable or a request is rejected","solution":"Compare the installed revision, actual API schema, optional plugin mount, HTTP-method restrictions and recorded validation/permission evidence. Do not bypass a refusal or send a production transaction to test documentation."}],"sources":[{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":87,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":115,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":135,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":158,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":179,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"related":["it-api-contract","it-api-auth","security-rcm-roles"],"verification":"Static API contract — behavior review pending","version":"f6e9f05f76d4","apiReferenceIds":["frontend-operation-56e9923f9f962d5e15","frontend-operation-f0086fcd93ec25dafe","frontend-operation-e60f49b7dad16c588d","frontend-operation-8c984c538c213b5ac6","frontend-operation-ce4b27691a8aa1277b"]},"backend":{"resources":[],"operations":[],"methodEvidence":[],"schemas":[],"frameworkSettings":[]},"frontend":{"operations":[{"id":"frontend-operation-56e9923f9f962d5e15","repository":"repositories/teleicu/mansoq-hmis-web","apiModule":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","operationKey":"anonymous","method":"UNRESOLVED","path":"/api/v1/facility/{facilityId}/location/{location.location.id}/association/{location.id}/","resolution":"template; runtime values required","originOmitted":false,"source":{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":87,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"location.location.id","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"location.id","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":null,"query":null,"clientNoAuth":null,"contractKind":"HTTP option object; client/server ownership review pending","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":[],"sourceFamily":"alternative/legacy frontend source","backendMatchStatus":"no exact statically resolved backend match in scanned contracts"},{"id":"frontend-operation-f0086fcd93ec25dafe","repository":"repositories/teleicu/mansoq-hmis-web","apiModule":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","operationKey":"anonymous","method":"UNRESOLVED","path":"/api/v1/facility/{facilityId}/location/{bedId}/association/","resolution":"template; runtime values required","originOmitted":false,"source":{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":115,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"bedId","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":null,"query":null,"clientNoAuth":null,"contractKind":"HTTP option object; client/server ownership review pending","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":[],"sourceFamily":"alternative/legacy frontend source","backendMatchStatus":"no exact statically resolved backend match in scanned contracts"},{"id":"frontend-operation-e60f49b7dad16c588d","repository":"repositories/teleicu/mansoq-hmis-web","apiModule":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","operationKey":"anonymous","method":"UNRESOLVED","path":"/api/v1/facility/{facilityId}/location/{location.id}/","resolution":"template; runtime values required","originOmitted":false,"source":{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":135,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"location.id","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":null,"query":null,"clientNoAuth":null,"contractKind":"HTTP option object; client/server ownership review pending","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":[],"sourceFamily":"alternative/legacy frontend source","backendMatchStatus":"no exact statically resolved backend match in scanned contracts"},{"id":"frontend-operation-8c984c538c213b5ac6","repository":"repositories/teleicu/mansoq-hmis-web","apiModule":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","operationKey":"anonymous","method":"UNRESOLVED","path":"/api/v1/facility/{facilityId}/location/{location.location.id}/association/{location.id}/","resolution":"template; runtime values required","originOmitted":false,"source":{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":158,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"location.location.id","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"location.id","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":null,"query":null,"clientNoAuth":null,"contractKind":"HTTP option object; client/server ownership review pending","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":[],"sourceFamily":"alternative/legacy frontend source","backendMatchStatus":"no exact statically resolved backend match in scanned contracts"},{"id":"frontend-operation-ce4b27691a8aa1277b","repository":"repositories/teleicu/mansoq-hmis-web","apiModule":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","operationKey":"anonymous","method":"UNRESOLVED","path":"/api/v1/facility/{facilityId}/location/{locationId}/association/{associationId}/","resolution":"template; runtime values required","originOmitted":false,"source":{"path":"repositories/teleicu/mansoq-hmis-web/src/components/Location/utils/locationHelpers.ts","line":179,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","pathParameters":[{"name":"facilityId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"locationId","type":"path string; semantic ID type requires contract confirmation","required":true},{"name":"associationId","type":"path string; semantic ID type requires contract confirmation","required":true}],"declaredQueryParameters":[],"request":null,"response":null,"query":null,"clientNoAuth":null,"contractKind":"HTTP option object; client/server ownership review pending","reviewStatus":"client contract extracted; runtime behavior and authorization review pending","backendOperationIds":[],"sourceFamily":"alternative/legacy frontend source","backendMatchStatus":"no exact statically resolved backend match in scanned contracts"}],"schemas":[]},"services":{"operations":[]},"boundaries":[]}