Container Environment Variables

Use these endpoints to read and modify the environment variables exposed to a running container. All operations authenticate with a JWT bearer token and act on a single container identified by {id}.

Each value has a max length of 32,768 characters. Keys must match the pattern ^[a-zA-Z_][a-zA-Z0-9_]*$ and must not start with the reserved HOODY_ prefix. Writes are mirrored to /etc/environment (visible on the next PAM/SSH login) and applied to the container runtime environment (visible to new exec/console sessions). Processes that are already running do not pick up the change until they re-exec.

Note

The reserved HOODY_ prefix is rejected on write and delete, so you cannot shadow, remove, or overwrite system-managed variables.

List environment variables

GET /api/v1/containers/{id}/env

Get all environment variables for a container.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID

Response

200

{
  "statusCode": 200,
  "message": "Environment variables retrieved",
  "data": {
    "environment_vars": {
      "NODE_ENV": "production",
      "DATABASE_URL": "postgres://user:pass@db.example.com:5432/app",
      "LOG_LEVEL": "info",
      "FEATURE_FLAGS": "new-dashboard,beta-search"
    }
  }
}

Error Code	Title	Description	Resolution
MISSING_TOKEN	Authentication token missing	No authentication token was provided in the request	Include a valid JWT token in the Authorization header as Bearer <token>
RESOURCE_ACCESS_DENIED	Resource access denied	You do not have permission to access this specific resource	Ensure you own this resource or have been granted access by the owner
CONTAINER_NOT_FOUND	Container not found	The requested container does not exist or you do not have permission to access it.	Verify the container ID is correct and that you have access to the project it belongs to.

SDK usage

cURL

curl -X GET 'https://api.hoody.com/api/v1/containers/{id}/env' \
  -H 'Authorization: Bearer <token>'

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });

await client.api.env.list(id);

Bulk set environment variables

PUT /api/v1/containers/{id}/env

Merge environment variables into the container. Existing keys are updated and new keys are added; keys not present in the body are left unchanged (merge semantics). Keys starting with HOODY_ are reserved and are rejected.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID

Request Body

The body is a JSON object whose entries are the variable keys and string values. Constraints:

• Object keys must match ^[a-zA-Z_][a-zA-Z0-9_]*$, must be 1 to 256 characters, and must not start with HOODY_.
• Each value is a string with a max length of 32,768 characters.
• The object must contain between 1 and 200 properties.

{
  "NODE_ENV": "production",
  "DATABASE_URL": "postgres://user:pass@db.example.com:5432/app",
  "REDIS_URL": "redis://cache.internal:6379/0",
  "FEATURE_FLAGS": "new-dashboard,beta-search"
}

Response

200

{
  "statusCode": 200,
  "message": "Environment variables updated",
  "data": {
    "environment_vars": {
      "NODE_ENV": "production",
      "DATABASE_URL": "postgres://user:pass@db.example.com:5432/app",
      "REDIS_URL": "redis://cache.internal:6379/0",
      "FEATURE_FLAGS": "new-dashboard,beta-search"
    },
    "synced": true
  }
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input parameters	One or more request parameters failed validation	Check the error message for specific field requirements and correct your input
INVALID_ENV_KEY	Invalid Environment Variable Key	The environment variable key is invalid. Keys must start with a letter or underscore, contain only alphanumeric characters and underscores, and must not start with the reserved HOODY_ prefix.	Use a key that matches [a-zA-Z_][a-zA-Z0-9_]* and does not start with HOODY_.
RESERVED_ENV_PREFIX	Reserved Environment Variable Prefix	Environment variable keys starting with HOODY_ are reserved for system use and cannot be set or deleted by users.	Use a different key name that does not start with HOODY_.
MISSING_TOKEN	Authentication token missing	No authentication token was provided in the request	Include a valid JWT token in the Authorization header as Bearer <token>
RESOURCE_ACCESS_DENIED	Resource access denied	You do not have permission to access this specific resource	Ensure you own this resource or have been granted access by the owner
CONTAINER_NOT_FOUND	Container not found	The requested container does not exist or you do not have permission to access it.	Verify the container ID is correct and that you have access to the project it belongs to.

SDK usage

cURL

curl -X PUT 'https://api.hoody.com/api/v1/containers/{id}/env' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "NODE_ENV": "production",
    "DATABASE_URL": "postgres://user:pass@db.example.com:5432/app",
    "REDIS_URL": "redis://cache.internal:6379/0"
  }'

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });

await client.api.env.bulkSet(id, {
  NODE_ENV: 'production',
  DATABASE_URL: 'postgres://user:pass@db.example.com:5432/app',
  REDIS_URL: 'redis://cache.internal:6379/0',
});

Set a single environment variable

PUT /api/v1/containers/{id}/env/{key}

Set or update a single environment variable on the container. Keys starting with HOODY_ are reserved and are rejected.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID
key	path	string	Yes	Environment variable key

Request Body

Name	Type	Required	Description
value	string	Yes	Value for the environment variable. Max 32,768 characters.

{
  "value": "postgres://user:pass@db.example.com:5432/app"
}

Response

200

{
  "statusCode": 200,
  "message": "Environment variable updated",
  "data": {
    "environment_vars": {
      "DATABASE_URL": "postgres://user:pass@db.example.com:5432/app"
    },
    "synced": true
  }
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input parameters	One or more request parameters failed validation	Check the error message for specific field requirements and correct your input
INVALID_ENV_KEY	Invalid Environment Variable Key	The environment variable key is invalid. Keys must start with a letter or underscore, contain only alphanumeric characters and underscores, and must not start with the reserved HOODY_ prefix.	Use a key that matches [a-zA-Z_][a-zA-Z0-9_]* and does not start with HOODY_.
RESERVED_ENV_PREFIX	Reserved Environment Variable Prefix	Environment variable keys starting with HOODY_ are reserved for system use and cannot be set or deleted by users.	Use a different key name that does not start with HOODY_.
MISSING_TOKEN	Authentication token missing	No authentication token was provided in the request	Include a valid JWT token in the Authorization header as Bearer <token>
RESOURCE_ACCESS_DENIED	Resource access denied	You do not have permission to access this specific resource	Ensure you own this resource or have been granted access by the owner
CONTAINER_NOT_FOUND	Container not found	The requested container does not exist or you do not have permission to access it.	Verify the container ID is correct and that you have access to the project it belongs to.

SDK usage

cURL

curl -X PUT 'https://api.hoody.com/api/v1/containers/{id}/env/DATABASE_URL' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "postgres://user:pass@db.example.com:5432/app"
  }'

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });

await client.api.env.set(id, 'DATABASE_URL', {
  value: 'postgres://user:pass@db.example.com:5432/app',
});

Delete an environment variable

DELETE /api/v1/containers/{id}/env/{key}

Remove a single environment variable from the container. The operation is idempotent and returns 200 whether the key existed or not. Keys starting with HOODY_ are reserved and cannot be deleted.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID
key	path	string	Yes	Environment variable key

Response

200

{
  "statusCode": 200,
  "message": "Environment variable deleted",
  "data": {
    "environment_vars": {
      "NODE_ENV": "production",
      "LOG_LEVEL": "info"
    },
    "synced": true
  }
}

Error Code	Title	Description	Resolution
RESERVED_ENV_PREFIX	Reserved Environment Variable Prefix	Environment variable keys starting with HOODY_ are reserved for system use and cannot be set or deleted by users.	Use a different key name that does not start with HOODY_.
MISSING_TOKEN	Authentication token missing	No authentication token was provided in the request	Include a valid JWT token in the Authorization header as Bearer <token>
RESOURCE_ACCESS_DENIED	Resource access denied	You do not have permission to access this specific resource	Ensure you own this resource or have been granted access by the owner
CONTAINER_NOT_FOUND	Container not found	The requested container does not exist or you do not have permission to access it.	Verify the container ID is correct and that you have access to the project it belongs to.

SDK usage

cURL

curl -X DELETE 'https://api.hoody.com/api/v1/containers/{id}/env/DATABASE_URL' \
  -H 'Authorization: Bearer <token>'

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });

await client.api.env.delete(id, 'DATABASE_URL');