← Technical API reference

Frontend module · STATIC DECLARATIONS

Facility Api client API reference · mansoq-people-fe

11 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 11 declarations come from repositories/platform/mansoq-people-fe/src/types/facility/facilityApi.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/ literal
default.create POST /api/v1/facility/ literal
default.update PUT /api/v1/facility/{facilityId}/ literal
default.delete DELETE /api/v1/facility/{facilityId}/ literal
default.get GET /api/v1/facility/{facilityId}/ literal
default.uploadCoverImage POST /api/v1/facility/{facilityId}/cover_image/ literal
default.deleteCoverImage DELETE /api/v1/facility/{facilityId}/cover_image/ literal
default.setInvoiceExpression POST /api/v1/facility/{facilityId}/set_invoice_expression/ literal
default.setMonetaryComponents POST /api/v1/facility/{facilityId}/set_monetary_config/ literal
default.getUsers GET /api/v1/facility/{facilityId}/users/ literal
default.getUser GET /api/v1/facility/{facilityId}/users/{userId}/ literal

default.list

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

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

PaginatedResponse declared fields:

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

Composed/inherited schema references: FacilityRead. 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/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

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

FacilityCreate declared fields:

Field Type Required Description
geo_organization string true —
features number[] true —
print_templates PrintTemplate[] false —

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

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

FacilityRead declared fields:

Field Type Required Description
read_cover_image_url string false —
cover_image_url string false —
created_date string false —
modified_date string false —
geo_organization Organization true —
instance_discount_codes Code[] true —
instance_discount_monetary_components MonetaryComponentRead[] true —
instance_informational_codes Code[] true —
instance_tax_codes Code[] true —
instance_tax_monetary_components MonetaryComponentRead[] true —
invoice_number_expression string true —
discount_codes Code[] true —
discount_monetary_components MonetaryComponentRead[] true —
discount_configuration DiscountConfiguration | null true —
patient_instance_identifier_configs PatientIdentifierConfig[] true —
patient_facility_identifier_configs PatientIdentifierConfig[] true —
features number[] true —
print_templates PrintTemplate[] true —

Composed/inherited schema references: FacilityBase, FacilityPermissions. 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.update

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

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

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

response type: FacilityRead. 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/{facilityId}/. typed route object; literal. multiple static method/path matches across source registrations; installed target and boundary require review.

Path parameters: facilityId. 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: Record<string, never>. 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.get

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

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

response type: FacilityRead. 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.uploadCoverImage

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

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

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

response type: FacilityRead. 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.deleteCoverImage

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

Path parameters: facilityId. 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: Record<string, never>. 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.setInvoiceExpression

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

Path parameters: facilityId. 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.setInvoiceExpression.request declared fields:

Field Type Required Description
invoice_number_expression string true —

response type: FacilityRead. 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.setMonetaryComponents

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

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

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

Code declared fields:

Field Type Required Description
system string true —
code string true —
display string true —

MonetaryComponentRead declared fields:

Field Type Required Description
title string true —

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

DiscountConfiguration declared fields:

Field Type Required Description
max_applicable number true —
applicability_order DiscountApplicabilityOrder true —

default.setMonetaryComponents.request declared fields:

Field Type Required Description
discount_codes Code[] true —
discount_monetary_components MonetaryComponentRead[] true —
discount_configuration DiscountConfiguration | null true —

response type: FacilityRead. 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.getUsers

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

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

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

UserReadMinimal declared fields:

Field Type Required Description
last_login string true —
profile_picture_url string true —
mfa_enabled boolean true —
deleted boolean true —
is_service_account boolean true —

Composed/inherited schema references: UserBase. 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.getUser

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

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

response type: UserReadMinimal. 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.

Pinned source evidence

Links require access to the private source repository.