Script Management

Read, write, delete, list, and organize scripts that the exec service manages on a container. All file operations act on the scripts root at /hoody/storage/hoody-exec/scripts on disk. Caller-supplied path values are normally instance-relative (for example deploy.ts or jobs/cleanup.ts); the service resolves them under the scope prefix <subdomain>/<execId>, where <subdomain> is the literal string default whenever the request host carries no subdomain. A complete prefix such as default/1/deploy.ts or a full absolute path is also accepted and left untouched. The fields resolvedPath, resolvedFrom, and resolvedTo returned by these endpoints are always scripts-root-relative.

Exec Ids

`GET /api/v1/exec/list`

List every exec instance ID available on this container, grouped by source (sdk vs custom).

This endpoint takes no parameters.

curl -X GET "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/list" \
  -H "Authorization: Bearer $HOODY_TOKEN"

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.ids.list();

{
  "execIds": [
    {
      "id": "1",
      "type": "sdk",
      "source_url": "https://github.com/hoody/sdk-scripts",
      "files": 14
    },
    {
      "id": "custom-build",
      "type": "custom",
      "files": 3
    }
  ],
  "total": 2,
  "summary": {
    "sdk": 1,
    "custom": 1
  }
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Magic Comments

`GET /api/v1/exec/magic-comments/read`

Parse and return the magic comments declared at the top of a script.

Parameters

Name	In	Type	Required	Description
`path`	query	string	Yes	Path query parameter

curl -X GET "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/magic-comments/read?path=deploy.ts" \
  -H "Authorization: Bearer $HOODY_TOKEN"

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.magic.read({ path: 'deploy.ts' });

{
  "path": "default/1/deploy.ts",
  "comments": {
    "mode": "on_demand",
    "timeout": 30000,
    "cors": "true"
  }
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`GET /api/v1/exec/magic-comments/schema`

Return the schema document that describes every magic-comment key, its directive, allowed values, and defaults.

This endpoint takes no parameters.

curl -X GET "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/magic-comments/schema" \
  -H "Authorization: Bearer $HOODY_TOKEN"

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.magic.getSchema();

{
  "schema_version": "1.0.0",
  "total_fields": 24,
  "parse_window_lines": 50,
  "unknown_keys_behavior": "ignore",
  "defaults_context": {
    "when_omitted": "fall back to runtime default",
    "runtime": "config/hoody-exec.runtime.json",
    "sdk_import": "config/hoody-exec.sdk-defaults.json"
  },
  "source_of_truth": {
    "interface": "exec_MagicCommentInterface",
    "parser": "exec_MagicCommentParser",
    "runtime_defaults": "exec_MagicCommentRuntimeDefaults",
    "sdk_import_defaults": "exec_MagicCommentSdkDefaults"
  },
  "categories": {
    "execution": ["mode", "timeout", "schedule"],
    "logging": ["level"],
    "cors": ["origins", "methods"],
    "ai": ["model", "prompt"],
    "metadata": ["author", "version"]
  },
  "fields": []
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`POST /api/v1/exec/magic-comments/bulk-update`

Apply the same magic-comment block to every script in a directory (or preview the changes with dry_run: true).

Request Body

Field	Type	Required	Default	Description
`directory`	string	No	-	Directory
`execId`	string	No	-	Exec Id
`comments`	string	No	-	Comments
`extension`	string	No	`".ts"`	Extension
`recursive`	boolean	No	`true`	Recursive
`dry_run`	boolean	No	`false`	Dry_run

curl -X POST "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/magic-comments/bulk-update" \
  -H "Authorization: Bearer $HOODY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "directory": "default/1",
    "execId": "1",
    "comments": "/* @mode on_demand\n   @timeout 30000 */",
    "extension": ".ts",
    "recursive": true,
    "dry_run": false
  }'

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.magic.bulkUpdate({
  directory: 'default/1',
  execId: '1',
  comments: '/* @mode on_demand\n   @timeout 30000 */',
  extension: '.ts',
  recursive: true,
  dry_run: false
});

{
  "dry_run": false,
  "directory": "default/1",
  "execId": "1",
  "recursive": true,
  "comments": {
    "mode": "on_demand",
    "timeout": 30000
  },
  "results": {
    "total": 2,
    "updated": 2,
    "failed": 0,
    "files": {
      "updated": ["default/1/deploy.ts", "default/1/jobs/cleanup.ts"],
      "failed": []
    }
  },
  "message": "Magic comments updated successfully"
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`PUT /api/v1/exec/magic-comments/update`

Update the magic comments on a single script (or preview the diff with dry_run: true).

Request Body

Field	Type	Required	Default	Description
`path`	string	Yes	-	Path
`comments`	string	No	-	Comments
`dry_run`	boolean	No	`false`	Dry_run

curl -X PUT "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/magic-comments/update" \
  -H "Authorization: Bearer $HOODY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "deploy.ts",
    "comments": "/* @mode scheduled\n   @timeout 60000\n   @cors true */",
    "dry_run": false
  }'

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.magic.updateHandler({
  path: 'deploy.ts',
  comments: '/* @mode scheduled\n   @timeout 60000\n   @cors true */',
  dry_run: false
});

{
  "dry_run": false,
  "path": "deploy.ts",
  "previous": {
    "mode": "on_demand",
    "timeout": 30000
  },
  "updated": {
    "mode": "scheduled",
    "timeout": 60000,
    "cors": "true"
  },
  "message": "Magic comments updated successfully"
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Scripts

`GET /api/v1/exec/scripts/list`

List the scripts in a directory with optional filtering by label, tags, mode, enabled state, and websocket binding.

Parameters

Name	In	Type	Required	Description
`dir`	query	string	No	Dir query parameter
`filter`	query	string	No	Filter query parameter
`metadata`	query	string	No	Metadata query parameter
`label`	query	string	No	Label query parameter
`tags`	query	string	No	Tags query parameter
`mode`	query	string	No	Mode query parameter
`enabled`	query	string	No	Enabled query parameter
`websocket`	query	string	No	Websocket query parameter
`recursive`	query	string	No	Recursive query parameter
`include_comments`	query	string	No	Include_comments query parameter
`execId`	query	string	No	Optional execution scope. When provided, relative paths resolve under `default/{execId}/` unless `subdomain` is also set. Query value takes precedence over body.
`exec_id`	query	string	No	Alias for `execId` (snake_case).
`subdomain`	query	string	No	Optional subdomain namespace used with `execId` for path resolution.

curl -X GET "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/scripts/list?recursive=false" \
  -H "Authorization: Bearer $HOODY_TOKEN"

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.scripts.list({ recursive: 'false' });

{
  "directory": "default/1",
  "count": 3,
  "recursive": false,
  "filters": {},
  "scripts": [
    {
      "name": "deploy.ts",
      "path": "default/1/deploy.ts",
      "isDirectory": false
    },
    {
      "name": "jobs",
      "path": "default/1/jobs",
      "isDirectory": true
    },
    {
      "name": "cleanup.ts",
      "path": "default/1/cleanup.ts",
      "isDirectory": false
    }
  ]
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`GET /api/v1/exec/scripts/read`

Read the contents of a single script along with its parsed magic comments and file metadata.

Parameters

Name	In	Type	Required	Description
`path`	query	string	Yes	Path query parameter
`execId`	query	string	No	Optional execution scope. When provided, relative paths resolve under `default/{execId}/` unless `subdomain` is also set. Query value takes precedence over body.
`exec_id`	query	string	No	Alias for `execId` (snake_case).
`subdomain`	query	string	No	Optional subdomain namespace used with `execId` for path resolution.

curl -X GET "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/scripts/read?path=deploy.ts" \
  -H "Authorization: Bearer $HOODY_TOKEN"

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.scripts.read({ path: 'deploy.ts' });

{
  "path": "deploy.ts",
  "resolvedPath": "default/1/deploy.ts",
  "content": "// @mode on_demand\n// @timeout 30000\nexport default async function main() {\n  console.log(\"deploying...\");\n}\n",
  "magicComments": {
    "mode": "on_demand",
    "timeout": 30000
  },
  "metadata": {
    "size": 128,
    "created": "2025-01-10T08:00:00.000Z",
    "modified": "2025-01-15T10:30:00.000Z",
    "isDirectory": false,
    "extension": ".ts"
  }
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`POST /api/v1/exec/scripts/write`

Create or update a script. By default, missing parent directories are created and the script is validated before it is persisted.

Parameters

Name	In	Type	Required	Description
`execId`	query	string	No	Optional execution scope. When provided, relative paths resolve under `default/{execId}/` unless `subdomain` is also set. Query value takes precedence over body.
`exec_id`	query	string	No	Alias for `execId` (snake_case).
`subdomain`	query	string	No	Optional subdomain namespace used with `execId` for path resolution.

Request Body

Field	Type	Required	Default	Description
`path`	string	Yes	-	Path
`content`	string	Yes	-	Content
`createDirs`	boolean	No	`true`	Create Dirs
`validate`	boolean	No	`true`	Validate
`execId`	string	No	-	Optional execution scope in request body. Query `execId`/`exec_id` takes precedence when both are provided.
`exec_id`	string	No	-	Alias for `execId` (snake_case).
`subdomain`	string	No	-	Optional subdomain namespace used with `execId` for path resolution.

curl -X POST "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/scripts/write" \
  -H "Authorization: Bearer $HOODY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "jobs/cleanup.ts",
    "content": "// @mode on_demand\nexport default async function main() {\n  console.log(\"cleaning up...\");\n}\n",
    "createDirs": true,
    "validate": true
  }'

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.scripts.write({
  path: 'jobs/cleanup.ts',
  content: '// @mode on_demand\nexport default async function main() {\n  console.log("cleaning up...");\n}\n',
  createDirs: true,
  validate: true
});

{
  "path": "jobs/cleanup.ts",
  "resolvedPath": "default/1/jobs/cleanup.ts",
  "created": true,
  "updated": false,
  "size": 84,
  "modified": "2025-01-15T10:30:00.000Z",
  "validated": true,
  "schedule": {
    "action": "added",
    "reason": "First write to this path"
  }
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`POST /api/v1/exec/scripts/move`

Rename or relocate a script. Both from and to are accepted in the same instance-relative or fully-prefixed form as path elsewhere on this page.

Parameters

Name	In	Type	Required	Description
`execId`	query	string	No	Optional execution scope. When provided, relative paths resolve under `default/{execId}/` unless `subdomain` is also set. Query value takes precedence over body.
`exec_id`	query	string	No	Alias for `execId` (snake_case).
`subdomain`	query	string	No	Optional subdomain namespace used with `execId` for path resolution.

Request Body

Field	Type	Required	Default	Description
`from`	string	Yes	-	From
`to`	string	Yes	-	To
`overwrite`	boolean	No	`false`	Overwrite
`execId`	string	No	-	Optional execution scope in request body. Query `execId`/`exec_id` takes precedence when both are provided.
`exec_id`	string	No	-	Alias for `execId` (snake_case).
`subdomain`	string	No	-	Optional subdomain namespace used with `execId` for path resolution.

curl -X POST "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/scripts/move" \
  -H "Authorization: Bearer $HOODY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "deploy.ts",
    "to": "jobs/deploy.ts",
    "overwrite": false
  }'

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.scripts.move({
  from: 'deploy.ts',
  to: 'jobs/deploy.ts',
  overwrite: false
});

{
  "moved": true,
  "from": "deploy.ts",
  "to": "jobs/deploy.ts",
  "resolvedFrom": "default/1/deploy.ts",
  "resolvedTo": "default/1/jobs/deploy.ts",
  "size": 128
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Resource already exists",
  "code": "CONFLICT",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`CONFLICT`	Resource conflict	Operation conflicts with existing resource state	Check resource state and retry

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`POST /api/v1/exec/scripts/tree`

Walk a directory and return a nested tree of scripts and subdirectories, capped at maxDepth.

Parameters

Name	In	Type	Required	Description
`execId`	query	string	No	Optional execution scope. When provided, relative paths resolve under `default/{execId}/` unless `subdomain` is also set. Query value takes precedence over body.
`exec_id`	query	string	No	Alias for `execId` (snake_case).
`subdomain`	query	string	No	Optional subdomain namespace used with `execId` for path resolution.

Request Body

Field	Type	Required	Default	Description
`baseDir`	string	No	`""`	Base Dir
`maxDepth`	integer	No	`10`	Max Depth
`includeMetadata`	boolean	No	`false`	Include Metadata
`execId`	string	No	-	Optional execution scope in request body. Query `execId`/`exec_id` takes precedence when both are provided.
`exec_id`	string	No	-	Alias for `execId` (snake_case).
`subdomain`	string	No	-	Optional subdomain namespace used with `execId` for path resolution.

curl -X POST "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/scripts/tree" \
  -H "Authorization: Bearer $HOODY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "baseDir": "",
    "maxDepth": 10,
    "includeMetadata": false
  }'

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.scripts.getTree({
  baseDir: '',
  maxDepth: 10,
  includeMetadata: false
});

{
  "baseDir": "default/1",
  "tree": [
    {
      "name": "deploy.ts",
      "path": "default/1/deploy.ts",
      "type": "file"
    },
    {
      "name": "jobs",
      "path": "default/1/jobs",
      "type": "directory",
      "children": [
        {
          "name": "cleanup.ts",
          "path": "default/1/jobs/cleanup.ts",
          "type": "file"
        }
      ]
    }
  ]
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

`DELETE /api/v1/exec/scripts/delete`

Delete a single script. The confirm query parameter is accepted as a safety check on the caller side but is not enforced by the server.

Parameters

Name	In	Type	Required	Description
`path`	query	string	Yes	Path query parameter
`confirm`	query	string	No	Confirm query parameter
`execId`	query	string	No	Optional execution scope. When provided, relative paths resolve under `default/{execId}/` unless `subdomain` is also set. Query value takes precedence over body.
`exec_id`	query	string	No	Alias for `execId` (snake_case).
`subdomain`	query	string	No	Optional subdomain namespace used with `execId` for path resolution.

curl -X DELETE "https://{projectId}-{containerId}-exec-1.{server}.containers.hoody.com/api/v1/exec/scripts/delete?path=deploy.ts" \
  -H "Authorization: Bearer $HOODY_TOKEN"

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.scripts.delete({ path: 'deploy.ts' });

{
  "deleted": true,
  "path": "deploy.ts",
  "resolvedPath": "default/1/deploy.ts",
  "size": 128
}

{
  "error": "Invalid parameter format",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Access denied",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Error Code	Title	Description	Resolution
`FORBIDDEN`	Access denied	Insufficient permissions for this operation	Contact administrator for access

{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

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

{
  "error": "Internal server error",
  "code": "ERROR_500",
  "timestamp": "2025-01-15T10:30:00.000Z"
}