Hoody Files

The Hoody Files API provides programmatic access to file management operations running inside a Hoody container. This page covers the system endpoints exposed by the Files service, including health and version discovery.

The Files service runs inside a per-container subdomain. All endpoints on this page are served from the container’s Files instance host.

System

System endpoints report metadata about the running Files service, such as its current version. Use these endpoints for health checks and to verify the version deployed in a container before integrating against it.

GET /api/v1/version

Returns the current API version and server information for the Files service.

This endpoint takes no parameters.

cURL

curl -X GET "https://{projectId}-{containerId}-files-1.{server}.containers.hoody.com/api/v1/version"

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://{projectId}-{containerId}-files-1.{server}.containers.hoody.com', token: process.env.HOODY_TOKEN });

await client.files.kit.getVersion();

Response

The response is a JSON object describing the running Files service version.

{
  "server_version": "1.2.3",
  "version": "1.0.0"
}

Field	Type	Description
server_version	string	The version of the underlying Files server process
version	string	The version of the Hoody Files API contract exposed by this server