System Monitoring

Health checks for the Files service. Use these endpoints to verify the service is running, inspect resource usage, and capture caller metadata.

Files Health

`GET /api/v1/files/health`

Standard service health endpoint. Returns service identity, build and start timestamps, resource usage, and caller metadata.

curl -X GET "https://67e89abc123def456789abcd-890abcdef12345678901cdef-files-1.node-example-1.containers.hoody.com/api/v1/files/health"

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://67e89abc123def456789abcd-890abcdef12345678901cdef-files-1.node-example-1.containers.hoody.com', token: process.env.HOODY_TOKEN });

await client.files.kit.getHealth();

{
  "built": "2025-01-15T08:30:00.000Z",
  "fds": 42,
  "ip": "203.0.113.10",
  "memory": {
    "heap": null,
    "rss": 15728640
  },
  "pid": 1,
  "service": "hoody-files",
  "started": "2025-01-15T08:30:00.000Z",
  "status": "ok",
  "userAgent": "curl/8.4.0"
}

Response Fields

Name	Type	Required	Description
`built`	string \| null	Yes	Build timestamp (ISO 8601).
`fds`	integer \| null	Yes	Open file descriptor count.
`ip`	string	Yes	Caller IP address. Empty for Unix socket connections.
`memory`	object	Yes	Current process memory usage.
`memory.heap`	integer \| null	Yes	Always `null` for native services.
`memory.rss`	integer \| null	Yes	Resident set size in bytes.
`pid`	integer	Yes	Process identifier.
`service`	string	Yes	Service identifier (e.g. `hoody-files`).
`started`	string	Yes	Service start timestamp (ISO 8601).
`status`	string	Yes	Health status string.
`userAgent`	string	Yes	Caller `User-Agent` header value.

Response Statuses

Service is healthy.

{
  "built": "2025-01-15T08:30:00.000Z",
  "fds": 42,
  "ip": "203.0.113.10",
  "memory": {
    "heap": null,
    "rss": 15728640
  },
  "pid": 1,
  "service": "hoody-files",
  "started": "2025-01-15T08:30:00.000Z",
  "status": "ok",
  "userAgent": "curl/8.4.0"
}