← Technical API reference

Frontend module · STATIC DECLARATIONS

Device Api client API reference · mansoq-hmis-web

16 client route/call declarations with path parameters, named payload/response types and source references. Exact server acceptance and permissions require the matched backend contract.

Static API contract — behavior review pending. Source baseline f6e9f05f76d4.

Enable JavaScript to inspect structured operation, parameter, schema and permission evidence. Download this reference and its evidence.

Client contract scope

These 16 declarations come from repositories/teleicu/mansoq-hmis-web/src/types/device/deviceApi.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.

Operation map

Client method HTTP method Path pattern Resolution
default.list GET /api/v1/facility/{facility_id}/device/ literal
default.create POST /api/v1/facility/{facility_id}/device/ literal
default.retrieve GET /api/v1/facility/{facility_id}/device/{id}/ literal
default.update PUT /api/v1/facility/{facility_id}/device/{id}/ literal
default.delete DELETE /api/v1/facility/{facility_id}/device/{id}/ literal
default.upsert POST /api/v1/facility/{facility_id}/device/upsert/ literal
default.associateLocation POST /api/v1/facility/{facility_id}/device/{id}/associate_location/ literal
default.serviceHistory.list GET /api/v1/facility/{facilityId}/device/{deviceId}/service_history/ literal
default.serviceHistory.retrieve GET /api/v1/facility/{facilityId}/device/{deviceId}/service_history/{id}/ literal
default.serviceHistory.create POST /api/v1/facility/{facilityId}/device/{deviceId}/service_history/ literal
default.serviceHistory.update PUT /api/v1/facility/{facilityId}/device/{deviceId}/service_history/{id}/ literal
default.associateEncounter POST /api/v1/facility/{facilityId}/device/{deviceId}/associate_encounter/ literal
default.encounterHistory GET /api/v1/facility/{facilityId}/device/{deviceId}/encounter_history/ literal
default.addOrganization POST /api/v1/facility/{facilityId}/device/{id}/add_managing_organization/ literal
default.removeOrganization POST /api/v1/facility/{facilityId}/device/{id}/remove_managing_organization/ literal
default.locationHistory GET /api/v1/facility/{facilityId}/device/{id}/location_history/ literal

default.list

GET /api/v1/facility/{facility_id}/device/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id. Transport strings are declared here; semantic identifier types require the server contract.

response type: PaginatedResponse<DeviceList>. client-side declaration; not proof of accepted server payload.

PaginatedResponse declared fields:

Field Type Required Description
count number true —
results TItem[] true —

DeviceList declared fields:

Field Type Required Description
id string true —
mansoq_metadata Record<string, unknown> true —

Composed/inherited schema references: DeviceBase. Exact generic composition is retained in the structured reference and requires server-side confirmation.

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.

default.create

POST /api/v1/facility/{facility_id}/device/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id. Transport strings are declared here; semantic identifier types require the server contract.

request type: DeviceWrite. client-side declaration; not proof of accepted server payload.

Composed/inherited schema references: DeviceBase. Exact generic composition is retained in the structured reference and requires server-side confirmation.

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

DeviceDetail declared fields:

Field Type Required Description
id string true —
current_encounter EncounterRead | undefined true —
current_location LocationRead | undefined true —
created_by UserReadMinimal true —
updated_by UserReadMinimal true —
mansoq_metadata Record<string, unknown> true —
managing_organization FacilityOrganizationRead | null true —

Composed/inherited schema references: DeviceBase. Exact generic composition is retained in the structured reference and requires server-side confirmation.

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.

default.retrieve

GET /api/v1/facility/{facility_id}/device/{id}/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id, id. Transport strings are declared here; semantic identifier types require the server contract.

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.update

PUT /api/v1/facility/{facility_id}/device/{id}/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id, id. Transport strings are declared here; semantic identifier types require the server contract.

request type: DeviceWrite. client-side declaration; not proof of accepted server payload.

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.delete

DELETE /api/v1/facility/{facility_id}/device/{id}/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id, id. Transport strings are declared here; semantic identifier types require the server contract.

request type: void. client-side declaration; not proof of accepted server payload.

response type: void. client-side declaration; not proof of accepted server payload.

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.

default.upsert

POST /api/v1/facility/{facility_id}/device/upsert/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id. Transport strings are declared here; semantic identifier types require the server contract.

request type: DeviceWrite. client-side declaration; not proof of accepted server payload.

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.associateLocation

POST /api/v1/facility/{facility_id}/device/{id}/associate_location/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facility_id, id. Transport strings are declared here; semantic identifier types require the server contract.

request type: object. client-side declaration; not proof of accepted server payload.

default.associateLocation.request declared fields:

Field Type Required Description
location string | null true —

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.serviceHistory.list

GET /api/v1/facility/{facilityId}/device/{deviceId}/service_history/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, deviceId. Transport strings are declared here; semantic identifier types require the server contract.

response type: PaginatedResponse<ServiceHistory>. client-side declaration; not proof of accepted server payload.

ServiceHistory declared fields:

Field Type Required Description
id string true —
serviced_on string true —
note string true —

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.

default.serviceHistory.retrieve

GET /api/v1/facility/{facilityId}/device/{deviceId}/service_history/{id}/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, deviceId, id. Transport strings are declared here; semantic identifier types require the server contract.

response type: ServiceHistory. client-side declaration; not proof of accepted server payload.

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.

default.serviceHistory.create

POST /api/v1/facility/{facilityId}/device/{deviceId}/service_history/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, deviceId. Transport strings are declared here; semantic identifier types require the server contract.

request type: ServiceHistoryWriteRequest. client-side declaration; not proof of accepted server payload.

ServiceHistoryWriteRequest declared fields:

Field Type Required Description
serviced_on string true —
note string true —

response type: ServiceHistory. client-side declaration; not proof of accepted server payload.

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.

default.serviceHistory.update

PUT /api/v1/facility/{facilityId}/device/{deviceId}/service_history/{id}/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, deviceId, id. Transport strings are declared here; semantic identifier types require the server contract.

request type: ServiceHistoryWriteRequest. client-side declaration; not proof of accepted server payload.

response type: ServiceHistory. client-side declaration; not proof of accepted server payload.

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.

default.associateEncounter

POST /api/v1/facility/{facilityId}/device/{deviceId}/associate_encounter/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, deviceId. Transport strings are declared here; semantic identifier types require the server contract.

request type: object. client-side declaration; not proof of accepted server payload.

default.associateEncounter.request declared fields:

Field Type Required Description
encounter string | null true —

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.encounterHistory

GET /api/v1/facility/{facilityId}/device/{deviceId}/encounter_history/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, deviceId. Transport strings are declared here; semantic identifier types require the server contract.

response type: PaginatedResponse<DeviceEncounterHistory>. client-side declaration; not proof of accepted server payload.

DeviceEncounterHistory declared fields:

Field Type Required Description
id string true —
encounter EncounterRead true —
created_by UserReadMinimal true —
start string true —
end string true —

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.

default.addOrganization

POST /api/v1/facility/{facilityId}/device/{id}/add_managing_organization/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, id. Transport strings are declared here; semantic identifier types require the server contract.

request type: object. client-side declaration; not proof of accepted server payload.

default.addOrganization.request declared fields:

Field Type Required Description
managing_organization string true —

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.removeOrganization

POST /api/v1/facility/{facilityId}/device/{id}/remove_managing_organization/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, id. Transport strings are declared here; semantic identifier types require the server contract.

request type: object. client-side declaration; not proof of accepted server payload.

default.removeOrganization.request declared fields:

Field Type Required Description
managing_organization string true —

response type: DeviceDetail. client-side declaration; not proof of accepted server payload.

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.

default.locationHistory

GET /api/v1/facility/{facilityId}/device/{id}/location_history/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId, id. Transport strings are declared here; semantic identifier types require the server contract.

response type: PaginatedResponse<DeviceLocationHistory>. client-side declaration; not proof of accepted server payload.

DeviceLocationHistory declared fields:

Field Type Required Description
id string true —
created_by UserReadMinimal true —
location LocationRead true —
start string true —
end string true —

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.

Pinned source evidence

Links require access to the private source repository.