Log Management

The Log Management endpoints let you discover, inspect, search, and clean up the execution logs produced by processes running inside a container. Use these routes to enumerate log files, tail a file in real time, pull a slice of a log into memory, run a multi-file search, or purge old log data. All routes are scoped to a specific container via the host template.

Note

Every endpoint in this group targets the container-scoped execution service. The host is always of the form https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.icu.

List Logs

GET /api/v1/exec/logs/list

Returns the available log files in the container. The response shape varies depending on whether type is supplied: with type the response includes a directory field; without it, the response returns a flat logs array.

Parameters

Name	In	Type	Required	Description
type	query	string	No	Type query parameter
limit	query	string	No	Limit query parameter

cURL

curl -X GET "https://proj123-cnt456-exec-1.eu-west.containers.hoody.icu/api/v1/exec/logs/list?type=application&limit=50"

SDK

await client.exec.logs.list({ type: "application", limit: "50" });

Response 200

{
  "directory": "/var/log/hoody/application",
  "count": 2,
  "logs": [
    {
      "file": "app-2025-01-15.log",
      "size": 24576,
      "modified": "2025-01-15T18:42:11Z"
    },
    {
      "file": "app-2025-01-16.log",
      "size": 51200,
      "modified": "2025-01-16T09:15:02Z"
    }
  ]
}

Response 400

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input	Request parameters failed validation	Check parameter format and requirements

Response 500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Stream Logs

GET /api/v1/exec/logs/stream

Streams the contents of a specific log file. Set follow=true to keep the connection open and receive new lines as they are written.

Parameters

Name	In	Type	Required	Description
file	query	string	Yes	File query parameter
follow	query	string	No	Follow query parameter

cURL

curl -X GET "https://proj123-cnt456-exec-1.eu-west.containers.hoody.icu/api/v1/exec/logs/stream?file=app-2025-01-16.log&follow=true"

SDK

await client.exec.logs.stream({ file: "app-2025-01-16.log", follow: "true" });

Response 400

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input	Request parameters failed validation	Check parameter format and requirements

Response 404

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
NOT_FOUND	Resource not found	The requested resource does not exist	Verify the resource identifier

Response 500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Tip

The 200 response is an open chunked text/event stream rather than a JSON document, so it is not shown as a fixed example. The connection remains open while follow=true.

Read Log

POST /api/v1/exec/logs/read

Reads a fixed window of lines from a log file. You can either pass file (a path inside the container) or executionId to target the log of a specific past execution. The response includes both the file metadata and the returned slice of lines.

Request Body

Name	Type	Required	Default	Description
file	string	No	—	File
executionId	string	No	—	Execution Id
lines	integer	No	100	Lines
tail	boolean	No	true	Tail
search	string	No	—	Search

cURL

curl -X POST "https://proj123-cnt456-exec-1.eu-west.containers.hoody.icu/api/v1/exec/logs/read" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "app-2025-01-16.log",
    "lines": 25,
    "tail": true,
    "search": "ERROR"
  }'

SDK

await client.exec.logs.read({
  file: "app-2025-01-16.log",
  lines: 25,
  tail: true,
  search: "ERROR"
});

Response 200

{
  "file": "app-2025-01-16.log",
  "totalLines": 1834,
  "filteredLines": 42,
  "returnedLines": 25,
  "lines": [
    "2025-01-16T10:31:01Z ERROR connection refused (db primary)",
    "2025-01-16T10:31:02Z ERROR retry 1/3",
    "2025-01-16T10:31:05Z ERROR connection refused (db primary)"
  ],
  "size": 51200,
  "modified": "2025-01-16T10:30:14Z"
}

Response 400

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input	Request parameters failed validation	Check parameter format and requirements

Response 404

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
NOT_FOUND	Resource not found	The requested resource does not exist	Verify the resource identifier

Response 500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Search Logs

POST /api/v1/exec/logs/search

Searches one or more log files for a literal substring or a regular expression. Use query for substring matching or regex for pattern matching. The response reports how many files were scanned and the total number of matches found.

Request Body

Name	Type	Required	Default	Description
query	string	No	—	Query
regex	string	No	—	Regex
files	array	No	—	Files
limit	integer	No	1000	Limit
caseSensitive	boolean	No	false	Case Sensitive

cURL

curl -X POST "https://proj123-cnt456-exec-1.eu-west.containers.hoody.icu/api/v1/exec/logs/search" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "OOMKilled",
    "files": ["app-2025-01-15.log", "app-2025-01-16.log"],
    "limit": 500,
    "caseSensitive": true
  }'

SDK

await client.exec.logs.search({
  query: "OOMKilled",
  files: ["app-2025-01-15.log", "app-2025-01-16.log"],
  limit: 500,
  caseSensitive: true
});

Response 200

{
  "query": "OOMKilled",
  "searchType": "substring",
  "filesSearched": 2,
  "matchesFound": 3,
  "results": [
    {
      "file": "app-2025-01-16.log",
      "lineNumber": 1742,
      "line": "2025-01-16T09:02:11Z container OOMKilled (exit 137)"
    }
  ]
}

Response 400

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input	Request parameters failed validation	Check parameter format and requirements

Response 500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Clear Logs

DELETE /api/v1/exec/logs/clear

Deletes log files from the container. Target a single file with file, a category with type, or age out old data with olderThanDays. Set confirm=true to authorize a destructive delete; the response reports how many files were removed and the total bytes reclaimed.

Caution

Clearing logs is destructive. Always pass confirm=true when you intend to delete, and prefer olderThanDays to keep recent logs intact.

Parameters

Name	In	Type	Required	Description
file	query	string	No	File query parameter
type	query	string	No	Type query parameter
olderThanDays	query	string	No	OlderThanDays query parameter
confirm	query	string	No	Confirm query parameter

cURL

curl -X DELETE "https://proj123-cnt456-exec-1.eu-west.containers.hoody.icu/api/v1/exec/logs/clear?olderThanDays=30&confirm=true"

SDK

await client.exec.logs.clear({ olderThanDays: "30", confirm: "true" });

Response 200

{
  "deleted": 17,
  "totalSize": 4194304,
  "message": "Removed 17 log file(s) older than 30 day(s); freed 4194304 bytes."
}

Response 400

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-16T10:32:14.812Z"
}

Error Code	Title	Description	Resolution
VALIDATION_ERROR	Invalid input	Request parameters failed validation	Check parameter format and requirements

Response 500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-16T10:32:14.812Z"
}