Proxy Hooks

Manage MITM hook scripts that intercept container traffic before it reaches the real upstream service. Hooks are stored per-service, evaluated in declared order (first-match-wins), and every write is ETag-gated with If-Match: file:v. The service names logs, proxy, workspaces, and cdp are reject-listed and cannot be targeted.

List all proxy hooks for a container

GET /api/v1/containers/{id}/proxy/hooks

Returns every hook grouped by service, together with the current file_version and ETag.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID

Response

{
  "statusCode": 200,
  "message": "Proxy hooks listed successfully",
  "data": {
    "hooks": {
      "api": [
        {
          "id": "01hz3x5k2n4q8w7vrgc6t1m4bz",
          "position": 0,
          "match": {
            "method": "POST",
            "path": "/v1/login",
            "headers": {
              "x-debug": "true"
            }
          },
          "script": {
            "path": "/workspace/hooks/login-trace.js"
          },
          "timeout": 1500,
          "applies_to": {
            "groups": ["qa", "preview"]
          }
        }
      ]
    },
    "file_version": 42,
    "etag": "file:v42"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.listContainerProxyHooks(id)

cURL

curl -X GET "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks" \
  -H "Authorization: Bearer <token>"

List hooks for a specific service

GET /api/v1/containers/{id}/proxy/hooks/{service}

Returns the ordered hook array for a single service. First-match-wins within this array.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name

Response

{
  "statusCode": 200,
  "message": "Service hooks listed successfully",
  "data": {
    "service": "api",
    "hooks": [
      {
        "id": "01hz3x5k2n4q8w7vrgc6t1m4bz",
        "position": 0,
        "match": {
          "method": "POST",
          "path": "/v1/login",
          "headers": {
            "x-debug": "true"
          }
        },
        "script": {
          "path": "/workspace/hooks/login-trace.js"
        },
        "timeout": 1500,
        "applies_to": {
          "groups": ["qa", "preview"]
        }
      }
    ],
    "file_version": 42,
    "etag": "file:v42"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.listContainerProxyServiceHooks(id, service)

cURL

curl -X GET "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api" \
  -H "Authorization: Bearer <token>"

Get a single hook

GET /api/v1/containers/{id}/proxy/hooks/{service}/{hookId}

Returns one hook by id, including the current file version and ETag.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name
`hookId`	path	string	Yes	26-char Crockford base32 ULID (lowercase)

Response

{
  "statusCode": 200,
  "message": "Hook retrieved successfully",
  "data": {
    "hook": {
      "id": "01hz3x5k2n4q8w7vrgc6t1m4bz",
      "position": 0,
      "match": {
        "method": "POST",
        "path": "/v1/login",
        "headers": {
          "x-debug": "true"
        }
      },
      "script": {
        "path": "/workspace/hooks/login-trace.js"
      },
      "timeout": 1500,
      "applies_to": {
        "groups": ["qa", "preview"]
      }
    },
    "file_version": 42,
    "etag": "file:v42"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.getContainerProxyHook(id, service, hookId)

cURL

curl -X GET "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api/01hz3x5k2n4q8w7vrgc6t1m4bz" \
  -H "Authorization: Bearer <token>"

Add a hook

POST /api/v1/containers/{id}/proxy/hooks/{service}

Append a new hook to a service, or insert at a specific position. Omit position to append to the end of the array. Requires If-Match.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name
`if-match`	header	string	No	`file:v` ETag precondition

Request Body

Field	Type	Required	Description
`match`	object	Yes	Request matcher — see fields below
`script`	object	Yes	Script reference — `path` is required
`timeout`	integer	No	Execution timeout in milliseconds (1 to 30000)
`applies_to`	object	No	Targeting — `groups` array of group names
`position`	integer	No	Zero-indexed insertion position

match fields:

Field	Type	Required	Description
`method`	string or array of strings	No	A single HTTP method (`*`, `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `HEAD`, `OPTIONS`) or an array of methods
`path`	string	No	URL path matcher, up to 257 characters
`headers`	object	No	Map of header name to expected value

script fields:

Field	Type	Required	Description
`path`	string	Yes	Filesystem path to the hook script
`subdomain`	string	No	Optional subdomain binding
`execId`	string	No	Optional pre-existing execution id

{
  "match": {
    "method": "GET",
    "path": "/v1/users/*",
    "headers": {
      "x-trace": "1"
    }
  },
  "script": {
    "path": "/workspace/hooks/user-trace.js"
  },
  "timeout": 1000,
  "applies_to": {
    "groups": ["qa"]
  }
}

Response

{
  "statusCode": 201,
  "message": "Hook created successfully",
  "data": {
    "hook": {
      "id": "01hz3x5k2n4q8w7vrgc6t1m4bz",
      "position": 1,
      "match": {
        "method": "GET",
        "path": "/v1/users/*",
        "headers": {
          "x-trace": "1"
        }
      },
      "script": {
        "path": "/workspace/hooks/user-trace.js"
      },
      "timeout": 1000,
      "applies_to": {
        "groups": ["qa"]
      }
    },
    "file_version": 43,
    "etag": "file:v43"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 412,
  "error": "Precondition Failed",
  "message": "etag_mismatch"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 422,
  "error": "Validation Error",
  "message": "Invalid hook"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 428,
  "error": "Precondition Required",
  "message": "If-Match header required for this operation"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.addContainerProxyHook(
  id,
  service,
  {
    match: { method: "GET", path: "/v1/users/*", headers: { "x-trace": "1" } },
    script: { path: "/workspace/hooks/user-trace.js" },
    timeout: 1000,
    applies_to: { groups: ["qa"] }
  },
  { ifMatch: "file:v42" }
)

cURL

curl -X POST "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "If-Match: file:v42" \
  -d '{
    "match": {
      "method": "GET",
      "path": "/v1/users/*",
      "headers": { "x-trace": "1" }
    },
    "script": { "path": "/workspace/hooks/user-trace.js" },
    "timeout": 1000,
    "applies_to": { "groups": ["qa"] }
  }'

Replace a hook in place

PUT /api/v1/containers/{id}/proxy/hooks/{service}/{hookId}

Full-replace a hook preserving its id and position. Requires If-Match.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name
`hookId`	path	string	Yes	26-char Crockford base32 ULID (lowercase)
`if-match`	header	string	No	`file:v` ETag precondition

Request Body

Field	Type	Required	Description
`match`	object	Yes	Request matcher — see fields below
`script`	object	Yes	Script reference — `path` is required
`timeout`	integer	No	Execution timeout in milliseconds (1 to 30000)
`applies_to`	object	No	Targeting — `groups` array of group names
`position`	integer	No	Zero-indexed insertion position (POST only)

match fields:

Field	Type	Required	Description
`method`	string or array of strings	No	A single HTTP method (`*`, `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `HEAD`, `OPTIONS`) or an array of methods
`path`	string	No	URL path matcher, up to 257 characters
`headers`	object	No	Map of header name to expected value

script fields:

Field	Type	Required	Description
`path`	string	Yes	Filesystem path to the hook script
`subdomain`	string	No	Optional subdomain binding
`execId`	string	No	Optional pre-existing execution id

{
  "match": {
    "method": "GET",
    "path": "/v1/users/*",
    "headers": {
      "x-trace": "1"
    }
  },
  "script": {
    "path": "/workspace/hooks/user-trace.js"
  },
  "timeout": 1000,
  "applies_to": {
    "groups": ["qa"]
  }
}

Response

{
  "statusCode": 200,
  "message": "Hook updated successfully",
  "data": {
    "hook": {
      "id": "01hz3x5k2n4q8w7vrgc6t1m4bz",
      "position": 0,
      "match": {
        "method": "GET",
        "path": "/v1/users/*",
        "headers": {
          "x-trace": "1"
        }
      },
      "script": {
        "path": "/workspace/hooks/user-trace.js"
      },
      "timeout": 1000,
      "applies_to": {
        "groups": ["qa"]
      }
    },
    "file_version": 44,
    "etag": "file:v44"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 412,
  "error": "Precondition Failed",
  "message": "etag_mismatch"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 422,
  "error": "Validation Error",
  "message": "Invalid hook"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 428,
  "error": "Precondition Required",
  "message": "If-Match header required for this operation"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.updateContainerProxyHook(
  id,
  service,
  hookId,
  {
    match: { method: "GET", path: "/v1/users/*", headers: { "x-trace": "1" } },
    script: { path: "/workspace/hooks/user-trace.js" },
    timeout: 1000,
    applies_to: { groups: ["qa"] }
  },
  { ifMatch: "file:v43" }
)

cURL

curl -X PUT "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api/01hz3x5k2n4q8w7vrgc6t1m4bz" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "If-Match: file:v43" \
  -d '{
    "match": {
      "method": "GET",
      "path": "/v1/users/*",
      "headers": { "x-trace": "1" }
    },
    "script": { "path": "/workspace/hooks/user-trace.js" },
    "timeout": 1000,
    "applies_to": { "groups": ["qa"] }
  }'

Move a hook to a new position

PATCH /api/v1/containers/{id}/proxy/hooks/{service}/{hookId}/position

Atomic reposition within the service array. Requires If-Match.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name
`hookId`	path	string	Yes	26-char Crockford base32 ULID (lowercase)
`if-match`	header	string	No	`file:v` ETag precondition

Request Body

Field	Type	Required	Description
`position`	integer	Yes	Zero-indexed destination position within the service array

{
  "position": 2
}

Response

{
  "statusCode": 200,
  "message": "Hook moved successfully",
  "data": {
    "hook": {
      "id": "01hz3x5k2n4q8w7vrgc6t1m4bz",
      "position": 2,
      "match": {
        "method": "POST",
        "path": "/v1/login",
        "headers": {
          "x-debug": "true"
        }
      },
      "script": {
        "path": "/workspace/hooks/login-trace.js"
      },
      "timeout": 1500,
      "applies_to": {
        "groups": ["qa", "preview"]
      }
    },
    "file_version": 45,
    "etag": "file:v45"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 412,
  "error": "Precondition Failed",
  "message": "etag_mismatch"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 428,
  "error": "Precondition Required",
  "message": "If-Match header required for this operation"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.moveContainerProxyHook(
  id,
  service,
  hookId,
  { position: 2 },
  { ifMatch: "file:v44" }
)

cURL

curl -X PATCH "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api/01hz3x5k2n4q8w7vrgc6t1m4bz/position" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "If-Match: file:v44" \
  -d '{ "position": 2 }'

Clear all hooks for a service

DELETE /api/v1/containers/{id}/proxy/hooks/{service}

Remove every hook under the named service. Requires If-Match.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name
`if-match`	header	string	No	`file:v` ETag precondition

Response

{
  "statusCode": 200,
  "message": "Service hooks cleared successfully",
  "data": {
    "removed": 3,
    "file_version": 46,
    "etag": "file:v46"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 412,
  "error": "Precondition Failed",
  "message": "etag_mismatch"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 428,
  "error": "Precondition Required",
  "message": "If-Match header required for this operation"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.clearContainerProxyServiceHooks(id, service, { ifMatch: "file:v45" })

cURL

curl -X DELETE "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api" \
  -H "Authorization: Bearer <token>" \
  -H "If-Match: file:v45"

Remove a hook

DELETE /api/v1/containers/{id}/proxy/hooks/{service}/{hookId}

Delete a single hook. Requires If-Match.

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Container ID
`service`	path	string	Yes	Service name
`hookId`	path	string	Yes	26-char Crockford base32 ULID (lowercase)
`if-match`	header	string	No	`file:v` ETag precondition

Response

{
  "statusCode": 200,
  "message": "Hook removed successfully",
  "data": {
    "file_version": 47,
    "etag": "file:v47"
  }
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 412,
  "error": "Precondition Failed",
  "message": "etag_mismatch"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

{
  "statusCode": 428,
  "error": "Precondition Required",
  "message": "If-Match header required for this operation"
}

Error Code	Title	Description	Resolution
`NOT_FOUND`	Hook or service not found	The hook id, service, or container does not exist, or the service is reject-listed	Verify the service name is not reject-listed (logs, proxy, workspaces, cdp) and that the hook id exists
`VALIDATION_ERROR`	Validation error	Request body violates hook schema, caps, or referential integrity	Check error details and correct the body shape; ensure `applies_to.groups` references defined groups
`PRECONDITION_REQUIRED`	If-Match required	Destructive writes require an `If-Match: file:v` header	Fetch the resource first to obtain the ETag and resend with `If-Match`
`PRECONDITION_FAILED`	ETag mismatch	The `If-Match` header does not match the current `file_version`	Re-fetch the resource to get the current ETag and retry

SDK

await client.api.proxyHooks.removeContainerProxyHook(id, service, hookId, { ifMatch: "file:v46" })

cURL

curl -X DELETE "https://api.hoody.icu/api/v1/containers/cnt_abc123/proxy/hooks/api/01hz3x5k2n4q8w7vrgc6t1m4bz" \
  -H "Authorization: Bearer <token>" \
  -H "If-Match: file:v46"