Script Management

Download Page (.md)

Script Management lets you discover, read, write, organize, and inspect executable scripts and their magic-comment metadata. Use these endpoints to browse exec IDs, list and traverse script directories, read or modify script content, move or delete files, and manage magic-comment directives used by the runtime.

Exec IDs

`GET /api/v1/exec/list`

Returns the IDs of all available exec scopes (SDK and custom) along with a summary count.

This endpoint takes no parameters.

curl -X GET https://api.hoody.com/v1/exec/list \
  -H "Authorization: Bearer <token>"

const { data } = await client.exec.ids.list();

{
  "execIds": [
    {
      "id": "exec_a1b2c3d4e5f6",
      "type": "sdk",
      "source_url": "https://github.com/hoody/scripts.git",
      "files": 12
    },
    {
      "id": "exec_custom_9z8y7x",
      "type": "custom",
      "files": 4
    }
  ],
  "total": 2,
  "summary": {
    "sdk": 1,
    "custom": 1
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "execIds",
    "reason": "Malformed payload"
  }
}

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

Magic comments are parsed directives embedded at the top of a script that control runtime behavior, logging, CORS, AI features, and metadata. The endpoints below let you read them, inspect their schema, and update them.

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

Parses and returns the magic-comment directives found at the top of a script file. Tokens are redacted in the response.

Parameters

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

curl -X GET "https://api.hoody.com/v1/exec/magic-comments/read?path=scripts/translate.ts" \
  -H "Authorization: Bearer <token>"

const { data } = await client.exec.magic.read({ path: "scripts/translate.ts" });

{
  "path": "scripts/translate.ts",
  "comments": {
    "runtime": "node22",
    "timeout": 30000,
    "logging": "info",
    "cors": true
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "path",
    "reason": "Path is required"
  }
}

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-15T10:30:00.000Z",
  "details": {
    "reason": "Insufficient permissions"
  }
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "script",
    "path": "scripts/missing.ts"
  }
}

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`

Returns the canonical schema describing every supported magic-comment directive, including categories, default values, and accepted ranges.

This endpoint takes no parameters.

curl -X GET https://api.hoody.com/v1/exec/magic-comments/schema \
  -H "Authorization: Bearer <token>"

const { data } = await client.exec.magic.getSchema();

{
  "schema_version": "1.0.0",
  "total_fields": 18,
  "parse_window_lines": 50,
  "unknown_keys_behavior": "warn",
  "defaults_context": {
    "when_omitted": "fallback",
    "runtime": "node22",
    "sdk_import": "@hoody/runtime"
  },
  "source_of_truth": {
    "interface": "MagicComment",
    "parser": "scripts/parser.ts",
    "runtime_defaults": "runtime/defaults.ts",
    "sdk_import_defaults": "@hoody/runtime/defaults"
  },
  "categories": {
    "execution": ["runtime", "timeout", "memory"],
    "logging": ["level", "redact"],
    "cors": ["origins"],
    "ai": ["model", "temperature"],
    "metadata": ["name", "owner"]
  },
  "fields": []
}

{
  "error": "VALIDATION_ERROR",
  "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`

Applies or previews a batch of magic-comment changes across every script in a directory. Supports dry_run to preview the diff before writing.

This endpoint takes no path, query, or header parameters.

Request Body

Name	Type	Required	Default	Description
`directory`	string	No	—	Target directory to scan
`execId`	string	No	—	Execution scope for path resolution
`comments`	string	No	—	New magic-comment block to apply
`extension`	string	No	`".ts"`	File extension filter
`recursive`	boolean	No	`true`	Recurse into subdirectories
`dry_run`	boolean	No	`false`	When true, returns a preview without writing

curl -X POST https://api.hoody.com/v1/exec/magic-comments/bulk-update \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "directory": "scripts",
    "comments": "// @hoody.comtime node22\n// @hoody.timeout 30000",
    "extension": ".ts",
    "recursive": true,
    "dry_run": true
  }'

const { data } = await client.exec.magic.bulkUpdate({
  directory: "scripts",
  comments: "// @hoody.comtime node22\n// @hoody.timeout 30000",
  extension: ".ts",
  recursive: true,
  dry_run: true,
});

{
  "dry_run": true,
  "directory": "scripts",
  "execId": "exec_a1b2c3d4e5f6",
  "recursive": true,
  "comments": {
    "runtime": "node22",
    "timeout": 30000
  },
  "would_affect": {
    "total": 2,
    "files": [
      {
        "file": "scripts/translate.ts",
        "current": { "runtime": "node20" },
        "proposed": { "runtime": "node22", "timeout": 30000 },
        "changes": ["runtime", "timeout"]
      },
      {
        "file": "scripts/summarize.ts",
        "current": null,
        "proposed": { "runtime": "node22", "timeout": 30000 },
        "changes": ["runtime", "timeout"]
      }
    ]
  },
  "message": "Preview only - set dry_run=false to apply changes"
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "directory",
    "reason": "Directory does not exist"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "directory",
    "directory": "scripts/missing"
  }
}

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`

Updates the magic comments of a single script file. Supports dry_run to preview changes before applying them.

This endpoint takes no path, query, or header parameters.

Request Body

Name	Type	Required	Default	Description
`path`	string	Yes	—	Path of the script to update
`comments`	string	No	—	New magic-comment block
`dry_run`	boolean	No	`false`	When true, returns a preview without writing

curl -X PUT https://api.hoody.com/v1/exec/magic-comments/update \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "scripts/translate.ts",
    "comments": "// @hoody.comtime node22",
    "dry_run": true
  }'

const { data } = await client.exec.magic.updateHandler({
  path: "scripts/translate.ts",
  comments: "// @hoody.comtime node22",
  dry_run: true,
});

{
  "dry_run": true,
  "path": "scripts/translate.ts",
  "current": { "runtime": "node20" },
  "proposed": { "runtime": "node22" },
  "changes": ["runtime"],
  "message": "Preview only - set dry_run=false to apply changes"
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "path",
    "reason": "Path is required"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "script",
    "path": "scripts/missing.ts"
  }
}

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

These endpoints operate on script files within an exec scope: listing, reading, writing, moving, traversing, and deleting.

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

Lists scripts and directories within a target folder, with optional filters for label, tags, mode, enabled state, and WebSocket usage.

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://api.hoody.com/v1/exec/scripts/list?dir=scripts&recursive=true&label=ai" \
  -H "Authorization: Bearer <token>"

const { data } = await client.exec.scripts.list({
  dir: "scripts",
  recursive: "true",
  label: "ai",
});

{
  "directory": "scripts",
  "count": 3,
  "recursive": true,
  "filters": {
    "label": "ai",
    "tags": "",
    "mode": "",
    "enabled": "",
    "websocket": ""
  },
  "scripts": [
    {
      "name": "translate.ts",
      "path": "scripts/translate.ts",
      "isDirectory": false
    },
    {
      "name": "summarize.ts",
      "path": "scripts/summarize.ts",
      "isDirectory": false
    },
    {
      "name": "agents",
      "path": "scripts/agents",
      "isDirectory": true
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "dir",
    "reason": "Invalid directory path"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "directory",
    "directory": "scripts/missing"
  }
}

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`

Reads the raw content of a script, 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://api.hoody.com/v1/exec/scripts/read?path=scripts/translate.ts" \
  -H "Authorization: Bearer <token>"

const { data } = await client.exec.scripts.read({ path: "scripts/translate.ts" });

{
  "path": "scripts/translate.ts",
  "resolvedPath": "/exec/exec_a1b2c3d4e5f6/scripts/translate.ts",
  "content": "// @hoody.comtime node22\nimport { translate } from '@hoody/runtime';\n\nexport default translate;\n",
  "magicComments": {
    "runtime": "node22"
  },
  "metadata": {
    "size": 142,
    "created": "2025-01-10T08:21:00.000Z",
    "modified": "2025-01-12T14:05:00.000Z",
    "isDirectory": false,
    "extension": ".ts"
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "path",
    "reason": "Path is required"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "script",
    "path": "scripts/missing.ts"
  }
}

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`

Creates or overwrites a script file. Optionally validates the content and creates intermediate 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

Name	Type	Required	Default	Description
`path`	string	Yes	—	Target path for the script
`content`	string	Yes	—	Full script content to write
`createDirs`	boolean	No	`true`	Create intermediate directories if missing
`validate`	boolean	No	`true`	Validate the script before persisting
`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://api.hoody.com/v1/exec/scripts/write \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "scripts/translate.ts",
    "content": "// @hoody.comtime node22\nexport default async () => \"ok\";\n",
    "createDirs": true,
    "validate": true
  }'

const { data } = await client.exec.scripts.write({
  path: "scripts/translate.ts",
  content: "// @hoody.comtime node22\nexport default async () => \"ok\";\n",
  createDirs: true,
  validate: true,
});

{
  "path": "scripts/translate.ts",
  "resolvedPath": "/exec/exec_a1b2c3d4e5f6/scripts/translate.ts",
  "created": false,
  "updated": true,
  "size": 168,
  "modified": "2025-01-15T10:30:00.000Z",
  "validated": true,
  "env": null,
  "schedule": {
    "action": "noop",
    "reason": "No scheduling directives declared"
  }
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "content",
    "reason": "Content failed validation"
  }
}

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-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`

Renames or relocates a script within an exec scope. Returns a 409 Conflict when 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

Name	Type	Required	Default	Description
`from`	string	Yes	—	Source path of the script
`to`	string	Yes	—	Destination path
`overwrite`	boolean	No	`false`	Allow replacing an existing destination
`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://api.hoody.com/v1/exec/scripts/move \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "scripts/draft/translate.ts",
    "to": "scripts/translate.ts",
    "overwrite": false
  }'

const { data } = await client.exec.scripts.move({
  from: "scripts/draft/translate.ts",
  to: "scripts/translate.ts",
  overwrite: false,
});

{
  "moved": true,
  "from": "scripts/draft/translate.ts",
  "to": "scripts/translate.ts",
  "resolvedFrom": "/exec/exec_a1b2c3d4e5f6/scripts/draft/translate.ts",
  "resolvedTo": "/exec/exec_a1b2c3d4e5f6/scripts/translate.ts",
  "size": 168
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "from",
    "reason": "Source path is required"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "script",
    "path": "scripts/draft/missing.ts"
  }
}

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-15T10:30:00.000Z",
  "details": {
    "reason": "Destination already exists",
    "path": "scripts/translate.ts"
  }
}

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`

Returns a hierarchical tree of scripts and folders rooted at the requested base directory.

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

Name	Type	Required	Default	Description
`baseDir`	string	No	`""`	Root directory to traverse
`maxDepth`	integer	No	`10`	Maximum tree depth
`includeMetadata`	boolean	No	`false`	Attach metadata to each node
`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://api.hoody.com/v1/exec/scripts/tree \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "baseDir": "scripts",
    "maxDepth": 5,
    "includeMetadata": false
  }'

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

{
  "baseDir": "scripts",
  "tree": [
    {
      "name": "scripts",
      "type": "directory",
      "children": [
        {
          "name": "translate.ts",
          "type": "file",
          "path": "scripts/translate.ts"
        },
        {
          "name": "agents",
          "type": "directory",
          "children": [
            {
              "name": "router.ts",
              "type": "file",
              "path": "scripts/agents/router.ts"
            }
          ]
        }
      ]
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "maxDepth",
    "reason": "maxDepth must be a positive integer"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "directory",
    "directory": "scripts/missing"
  }
}

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`

Permanently removes a script file. A confirm token is recommended to guard against accidental deletion.

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://api.hoody.com/v1/exec/scripts/delete?path=scripts/translate.ts&confirm=true" \
  -H "Authorization: Bearer <token>"

const { data } = await client.exec.scripts.delete({
  path: "scripts/translate.ts",
  confirm: "true",
});

{
  "deleted": true,
  "path": "scripts/translate.ts",
  "resolvedPath": "/exec/exec_a1b2c3d4e5f6/scripts/translate.ts",
  "size": 168
}

{
  "error": "VALIDATION_ERROR",
  "code": "VALIDATION_ERROR",
  "timestamp": "2025-01-15T10:30:00.000Z",
  "details": {
    "field": "path",
    "reason": "Path is required"
  }
}

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-15T10:30:00.000Z"
}

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-15T10:30:00.000Z",
  "details": {
    "resource": "script",
    "path": "scripts/missing.ts"
  }
}

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"
}