Script Management

The Script Management API provides endpoints for reading, writing, deleting, listing, and organizing scripts stored in the execution service. Use these endpoints to manage SDK-sourced scripts and custom scripts, manipulate magic comments that control script behavior, and navigate the script directory tree.

All endpoints in this section are scoped to a specific container, so the base URL follows the per-container pattern shown under each operation.

Exec IDs

`GET /api/v1/exec/list`

List every exec ID available in the container, grouped by type (SDK or custom), with a summary count.

This endpoint takes no parameters.

curl -X GET "https://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/list"

const result = await client.exec.ids.list();

{
  "execIds": [
    {
      "id": "01HXYZ1234567890ABCDEFGHJ",
      "type": "sdk",
      "source_url": "https://github.com/example/sdk-scripts",
      "files": 12
    },
    {
      "id": "01HXYZ9876543210ZYXWVUTSR",
      "type": "custom",
      "files": 5
    }
  ],
  "total": 2,
  "summary": {
    "sdk": 1,
    "custom": 1
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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-20T14:30:00.000Z"
}

Magic Comments

Magic comments are directives embedded at the top of script files that configure runtime behavior (for example, enabling webhooks, declaring required env vars, or setting CORS origins). The endpoints below let you read, validate, and update them in bulk or per file.

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

Returns the canonical schema describing every supported magic comment directive, including defaults and source-of-truth metadata.

This endpoint takes no parameters.

curl -X GET "https://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/magic-comments/schema"

const schema = await client.exec.magic.getSchema();

{
  "schema_version": "1.0.0",
  "total_fields": 15,
  "parse_window_lines": 30,
  "unknown_keys_behavior": "ignored",
  "defaults_context": {
    "when_omitted": "fallback to runtime defaults",
    "runtime": "see runtime_defaults section",
    "sdk_import": "see sdk_import_defaults section"
  },
  "source_of_truth": {
    "interface": "MagicCommentMap",
    "parser": "src/lib/magicComments/parser.ts",
    "runtime_defaults": "src/lib/magicComments/defaults.ts",
    "sdk_import_defaults": "sdk/src/magicComments/defaults.ts"
  },
  "categories": {
    "execution": ["enable-webhooks", "webhook-url"],
    "logging": ["log-level"],
    "cors": ["cors-origins"],
    "ai": ["ai-model"],
    "metadata": ["description", "author"]
  },
  "fields": [
    {
      "key": "enable-webhooks",
      "directive": "@enable-webhooks",
      "category": "execution",
      "type": "boolean",
      "enum_values": ["true", "false"],
      "description": "Enable webhook execution mode for the script",
      "defaults": {
        "when_omitted": false,
        "runtime": false,
        "sdk_import": false
      },
      "examples": ["@enable-webhooks true"]
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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-20T14:30:00.000Z"
}

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

Parse and return the magic comments block at the top of a given script. Tokens are redacted in the response.

Parameters

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

curl -X GET "https://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/magic-comments/read?path=default%2Fhello-world.ts"

const comments = await client.exec.magic.read({ path: 'default/hello-world.ts' });

{
  "path": "default/hello-world.ts",
  "comments": {
    "@enable-webhooks": "true",
    "@webhook-url": "https://example.com/hook",
    "@required-env-vars": "API_KEY,API_SECRET",
    "@description": "Example webhook handler"
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}

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

Update the magic comments block on a single script. Set dry_run to true to preview changes without writing to disk.

This endpoint takes no parameters.

Request Body

Field	Type	Required	Default	Description
`path`	string	Yes	-	Path of the script to update
`comments`	string	No	-	Comments payload (raw magic-comment block)
`dry_run`	boolean	No	`false`	When `true`, returns a preview without modifying the file

curl -X PUT "https://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/magic-comments/update" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "default/hello-world.ts",
    "comments": "@enable-webhooks true\n@webhook-url https://example.com/hook\n",
    "dry_run": false
  }'

const result = await client.exec.magic.updateHandler({
  path: 'default/hello-world.ts',
  comments: '@enable-webhooks true\n@webhook-url https://example.com/hook\n',
  dry_run: false
});

{
  "dry_run": false,
  "path": "default/hello-world.ts",
  "previous": {
    "@enable-webhooks": "false"
  },
  "updated": {
    "@enable-webhooks": "true",
    "@webhook-url": "https://example.com/hook"
  },
  "message": "Magic comments updated successfully"
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}

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

Update the magic comments block across every script in a directory. Supports a dry_run preview and recursive traversal.

This endpoint takes no parameters.

Request Body

Field	Type	Required	Default	Description
`directory`	string	No	-	Target directory (relative to `SCRIPT_DIR`).
`execId`	string	No	-	Execution scope; resolves under `default/{execId}/` unless `subdomain` is also set.
`comments`	string	No	-	Raw magic-comment block to apply to each file.
`extension`	string	No	`".ts"`	File extension to consider when scanning.
`recursive`	boolean	No	`true`	Recurse into subdirectories.
`dry_run`	boolean	No	`false`	When `true`, returns a preview without modifying files.

curl -X POST "https://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/magic-comments/bulk-update" \
  -H "Content-Type: application/json" \
  -d '{
    "directory": "default",
    "execId": "01HXYZ1234567890ABCDEFGHJ",
    "comments": "@enable-webhooks true\n@cors-origins *\n",
    "extension": ".ts",
    "recursive": true,
    "dry_run": true
  }'

const preview = await client.exec.magic.bulkUpdate({
  directory: 'default',
  execId: '01HXYZ1234567890ABCDEFGHJ',
  comments: '@enable-webhooks true\n@cors-origins *\n',
  extension: '.ts',
  recursive: true,
  dry_run: true
});

{
  "dry_run": true,
  "directory": "default",
  "execId": "01HXYZ1234567890ABCDEFGHJ",
  "recursive": true,
  "comments": {
    "@enable-webhooks": "true",
    "@cors-origins": "*"
  },
  "would_affect": {
    "total": 2,
    "files": [
      {
        "file": "default/hello-world.ts",
        "current": { "@enable-webhooks": "false" },
        "proposed": { "@enable-webhooks": "true", "@cors-origins": "*" },
        "changes": ["add @enable-webhooks", "add @cors-origins"]
      },
      {
        "file": "default/utils/format.ts",
        "error": "Permission denied"
      }
    ]
  },
  "message": "Preview only - set dry_run=false to apply changes"
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}

Scripts

The script endpoints manage file-level operations: listing, reading, writing, moving, deleting, and visualizing the directory tree.

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

List scripts in a directory. Supports filtering by metadata (label, tags, mode, enabled, websocket) and optional recursion.

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://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/scripts/list?dir=default&recursive=true&execId=01HXYZ1234567890ABCDEFGHJ"

const listing = await client.exec.scripts.list({
  dir: 'default',
  recursive: 'true',
  execId: '01HXYZ1234567890ABCDEFGHJ'
});

{
  "directory": "default",
  "count": 3,
  "recursive": true,
  "filters": {
    "label": "webhook",
    "tags": "api",
    "mode": "edge",
    "enabled": "true",
    "websocket": "false"
  },
  "scripts": [
    {
      "name": "hello-world.ts",
      "path": "default/hello-world.ts",
      "isDirectory": false
    },
    {
      "name": "utils",
      "path": "default/utils",
      "isDirectory": true
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}

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

Read a single script file and return its content together with parsed magic comments and filesystem 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://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/scripts/read?path=default%2Fhello-world.ts"

const script = await client.exec.scripts.read({
  path: 'default/hello-world.ts'
});

{
  "path": "default/hello-world.ts",
  "resolvedPath": "/scripts/default/hello-world.ts",
  "content": "export default async function handler(req, res) {\n  res.json({ ok: true });\n}\n",
  "magicComments": {
    "@enable-webhooks": "true",
    "@description": "Example webhook handler"
  },
  "metadata": {
    "size": 128,
    "created": "2025-01-10T08:00:00.000Z",
    "modified": "2025-01-20T14:30:00.000Z",
    "isDirectory": false,
    "extension": ".ts"
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}

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

Create or overwrite a script file. Validates the script content and optionally creates missing parent directories.

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 of the script to write.
`content`	string	Yes	-	Script source content.
`createDirs`	boolean	No	`true`	Create parent directories if they do not exist.
`validate`	boolean	No	`true`	Validate script content before writing.
`execId`	string	No	-	Optional execution scope in the 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://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/scripts/write" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "default/hello-world.ts",
    "content": "export default async function handler(req, res) {\n  res.json({ ok: true });\n}\n",
    "createDirs": true,
    "validate": true
  }'

const result = await client.exec.scripts.write({
  path: 'default/hello-world.ts',
  content: 'export default async function handler(req, res) {\n  res.json({ ok: true });\n}\n',
  createDirs: true,
  validate: true
});

{
  "path": "default/hello-world.ts",
  "resolvedPath": "/scripts/default/hello-world.ts",
  "created": false,
  "updated": true,
  "size": 128,
  "modified": "2025-01-20T14:30:00.000Z",
  "validated": true,
  "env": {
    "API_KEY": { "required": true, "type": "string" }
  },
  "schedule": {
    "action": "noop",
    "reason": "No changes required"
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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-20T14:30:00.000Z"
}

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

Rename or move a script from one path to another. Returns a conflict if the destination already exists and overwrite is false.

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	-	Source path
`to`	string	Yes	-	Destination path
`overwrite`	boolean	No	`false`	Overwrite the destination if it already exists
`execId`	string	No	-	Optional execution scope in the 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://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/scripts/move" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "old-folder/script.ts",
    "to": "new-folder/script.ts",
    "overwrite": false
  }'

const result = await client.exec.scripts.move({
  from: 'old-folder/script.ts',
  to: 'new-folder/script.ts',
  overwrite: false
});

{
  "moved": true,
  "from": "old-folder/script.ts",
  "to": "new-folder/script.ts",
  "resolvedFrom": "/scripts/old-folder/script.ts",
  "resolvedTo": "/scripts/new-folder/script.ts",
  "size": 128
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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

{
  "error": "CONFLICT",
  "code": "CONFLICT",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource already exists"
  }
}

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-20T14:30:00.000Z"
}

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

Return a hierarchical tree view of the script directory, with configurable depth and optional file metadata.

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	`""`	Root directory for the tree
`maxDepth`	integer	No	`10`	Maximum recursion depth
`includeMetadata`	boolean	No	`false`	Include per-entry metadata in the tree
`execId`	string	No	-	Optional execution scope in the 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://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/scripts/tree" \
  -H "Content-Type: application/json" \
  -d '{
    "baseDir": "default",
    "maxDepth": 5,
    "includeMetadata": false
  }'

const tree = await client.exec.scripts.getTree({
  baseDir: 'default',
  maxDepth: 5,
  includeMetadata: false
});

{
  "baseDir": "/scripts/default",
  "tree": [
    {
      "name": "scripts",
      "path": "/scripts/default/scripts",
      "type": "directory",
      "children": [
        {
          "name": "hello-world.ts",
          "path": "/scripts/default/scripts/hello-world.ts",
          "type": "file",
          "size": 128
        },
        {
          "name": "utils",
          "path": "/scripts/default/scripts/utils",
          "type": "directory",
          "children": []
        }
      ]
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}

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

Delete a script file. Pass confirm=true to bypass safety checks.

Parameters

Name	In	Type	Required	Description
`path`	query	string	Yes	Path of the script to delete
`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://proj-abc123-cont-xyz789-exec-1.eu-west-1.containers.hoody.icu/api/v1/exec/scripts/delete?path=default%2Fhello-world.ts&confirm=true"

const result = await client.exec.scripts.delete({
  path: 'default/hello-world.ts',
  confirm: 'true'
});

{
  "deleted": true,
  "path": "default/hello-world.ts",
  "resolvedPath": "/scripts/default/hello-world.ts",
  "size": 128
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Invalid parameter format"
  }
}

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

{
  "error": "FORBIDDEN",
  "code": "FORBIDDEN",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Access denied"
  }
}

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

{
  "error": "NOT_FOUND",
  "code": "NOT_FOUND",
  "timestamp": "2025-01-20T14:30:00.000Z",
  "details": {
    "message": "Resource not found"
  }
}

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-20T14:30:00.000Z"
}