Log Management

The execution log API surfaces every log file produced by commands run inside an exec container. Use these endpoints to enumerate available logs, stream them in real time, read paginated slices, run full-text or regex searches, and prune old entries. All endpoints are scoped to a single exec instance and require a valid Hoody access token in the Authorization header.

The base URL for every operation on this page is https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com.

---

List Logs

GET /api/v1/exec/logs/list

Enumerate log files and directories available to the exec instance. Use the optional type filter to narrow the result to a specific log class and limit to cap the number of entries returned.

Parameters

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

Examples

cURL

curl -G "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/logs/list" \
  -H "Authorization: Bearer <token>" \
  --data-urlencode "type=execution" \
  --data-urlencode "limit=50"

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

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

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

Response (200)

{
  "logs": [
    {
      "name": "executions.log",
      "path": "/var/log/hoody/executions.log",
      "size": 24576,
      "modified": "2026-01-15T10:42:13.000Z"
    },
    {
      "name": "errors.log",
      "path": "/var/log/hoody/errors.log",
      "size": 8192,
      "modified": "2026-01-15T10:41:02.000Z"
    }
  ],
  "count": 2
}

400

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "field": "limit",
    "reason": "Must be a positive integer"
  }
}

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

500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {}
}

---

Stream Logs

GET /api/v1/exec/logs/stream

Open a live stream of a log file. The response stays open and emits new lines as they are appended to the file. Set follow=true to receive ongoing output (equivalent to tail -f); omit it for a one-shot dump.

Parameters

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

Examples

cURL

curl "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/logs/stream?file=executions.log&follow=true" \
  -H "Authorization: Bearer <token>"

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

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

await client.exec.logs.stream({ file: 'executions.log', follow: 'true' });

400

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "field": "file",
    "reason": "File parameter is required"
  }
}

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

404

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "resource": "log file",
    "name": "missing.log"
  }
}

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

500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {}
}

---

Read Log

POST /api/v1/exec/logs/read

Read a slice of a log file. Provide either file (a path) or executionId to identify the log. tail controls whether the slice is taken from the end or the beginning, lines caps the returned slice, and search filters lines to those containing the given substring.

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

Examples

cURL

curl -X POST "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/logs/read" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "executions.log",
    "lines": 50,
    "tail": true,
    "search": "ERROR"
  }'

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

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

await client.exec.logs.read({
  file: 'executions.log',
  lines: 50,
  tail: true,
  search: 'ERROR'
});

Response (200)

{
  "file": "executions.log",
  "totalLines": 12480,
  "filteredLines": 312,
  "returnedLines": 50,
  "lines": [
    "2026-01-15T10:41:55.123Z [ERROR] Failed to connect to upstream service",
    "2026-01-15T10:41:57.481Z [ERROR] Retry attempt 2 timed out"
  ],
  "size": 24576,
  "modified": "2026-01-15T10:42:13.000Z"
}

400

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "field": "lines",
    "reason": "Must be a positive integer"
  }
}

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

404

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "resource": "log file",
    "name": "missing.log"
  }
}

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

500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {}
}

---

Search Logs

POST /api/v1/exec/logs/search

Search one or more log files for a substring (query) or a regular expression (regex). Use files to restrict the search to specific files; omit it to search every log file known to the container.

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

Examples

cURL

curl -X POST "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/logs/search" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "regex": "Failed to connect .* upstream",
    "files": ["executions.log", "errors.log"],
    "limit": 500,
    "caseSensitive": false
  }'

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

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

await client.exec.logs.search({
  regex: 'Failed to connect .* upstream',
  files: ['executions.log', 'errors.log'],
  limit: 500,
  caseSensitive: false
});

Response (200)

{
  "query": "Failed to connect .* upstream",
  "searchType": "regex",
  "filesSearched": 2,
  "matchesFound": 17,
  "results": [
    {
      "file": "executions.log",
      "lineNumber": 12402,
      "line": "2026-01-15T10:41:55.123Z [ERROR] Failed to connect to upstream service",
      "timestamp": "2026-01-15T10:41:55.123Z"
    }
  ]
}

400

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "field": "regex",
    "reason": "Invalid regular expression pattern"
  }
}

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

500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {}
}

---

Clear Logs

DELETE /api/v1/exec/logs/clear

Delete log files or log entries. Without filters the operation refuses to run: either scope it to a single file with file, a log type with type, entries older than a threshold with olderThanDays, or set confirm=true to acknowledge a wholesale purge.

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

Examples

cURL

curl -X DELETE "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/logs/clear?type=execution&olderThanDays=30&confirm=true" \
  -H "Authorization: Bearer <token>"

TypeScript SDK

import { HoodyClient } from 'hoody-sdk';

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

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

Response (200)

{
  "deleted": 42,
  "totalSize": 1048576,
  "message": "Cleared 42 log entries older than 30 days."
}

400

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {
    "reason": "Destructive operation requires either confirm=true or a scoped filter"
  }
}

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

500

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2026-01-15T10:42:13.000Z",
  "details": {}
}

Caution

Clearing logs is irreversible. Always scope the request with file, type, or olderThanDays, or explicitly pass confirm=true. Once a log entry is deleted it cannot be recovered.