Loft Interfaces

Manage monitored interfaces.

Loft is a Pro product. These routes are served by the Loft desktop app’s local Bridge on loopback (localhost:5100) for the signed-in user, which resolves the Professional tier locally, so a local call needs no API key. This is not a hosted API and is not reachable from another machine. A request below the Professional tier returns 402, never a hard 403.

GET /api/loft/interfaces

List all interfaces.

curl

curl http://localhost:5100/api/loft/interfaces

POST /api/loft/interfaces

Create a new interface.

Field	Type	Default	Description
`name`	string	Required	Display name
`directoryPath`	string	Required	Filesystem path to watch
`profileName`	string	none	Vendor profile for validation
`filePattern`	string	`"*.hl7"`	Glob pattern for message files

curl

curl -X POST http://localhost:5100/api/loft/interfaces \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ER Interface",
    "directoryPath": "/var/loft/er",
    "profileName": "epic_er",
    "filePattern": "*.hl7"
  }'

GET /api/loft/interfaces/

Get interface by ID.

curl

curl http://localhost:5100/api/loft/interfaces/intf-001

PUT /api/loft/interfaces/

Update an interface. All fields optional.

Field	Type	Description
`name`	string	Updated display name
`profileName`	string	Updated vendor profile
`filePattern`	string	Updated file pattern
`enabled`	boolean	Enable/disable monitoring

curl

curl -X PUT http://localhost:5100/api/loft/interfaces/intf-001 \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

DELETE /api/loft/interfaces/

Delete an interface.

curl

curl -X DELETE http://localhost:5100/api/loft/interfaces/intf-001

GET /api/loft/interfaces//metrics

Get interface metrics.

Query Param	Type	Default	Description
`sinceHours`	int	`24`	Hours of history

curl

curl "http://localhost:5100/api/loft/interfaces/intf-001/metrics?sinceHours=12"

Response includes totalMessagesProcessed, totalErrors, totalSuccesses, errorRate, lastMessageAt, startedAt, uptimeSeconds, and an hourlyBreakdown array (each bucket has hour, messagesProcessed, errors, and successes).

Overview

Core APIs

Loft APIs

Flock APIs

Live Updates

GET /api/loft/interfaces

POST /api/loft/interfaces

GET /api/loft/interfaces/

PUT /api/loft/interfaces/

DELETE /api/loft/interfaces/

GET /api/loft/interfaces//metrics

​GET /api/loft/interfaces

​POST /api/loft/interfaces

​GET /api/loft/interfaces/

​PUT /api/loft/interfaces/

​DELETE /api/loft/interfaces/

​GET /api/loft/interfaces//metrics

GET /api/loft/interfaces

POST /api/loft/interfaces

GET /api/loft/interfaces/

PUT /api/loft/interfaces/

DELETE /api/loft/interfaces/

GET /api/loft/interfaces//metrics