Overview

The Proxy Discovery endpoints enumerate proxy groups and services attached to a container, and return a merged debug view of the proxy configuration for a specific service. Use these endpoints to inspect which groups, services, hooks, and effective defaults are currently defined for a container’s proxy.

Note

Container IDs are 24-character lowercase-hex ObjectIds. The examples below use 507f1f77bcf86cd799439012 as a valid placeholder.

List container proxy groups

Returns all defined proxy group names along with the count of auth rules registered for each group. The response includes the current file_version and etag so callers can detect configuration drift between successive reads.

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

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID

This endpoint takes no request body.

cURL

curl -X GET "https://api.hoody.com/api/v1/containers/507f1f77bcf86cd799439012/proxy/groups" \
  -H "Authorization: Bearer <token>"

SDK

const result = await client.api.proxyDiscovery.listContainerProxyGroups({
  id: "507f1f77bcf86cd799439012"
});

Response 200

{
  "statusCode": 200,
  "message": "OK",
  "data": {
    "groups": [
      { "name": "admins", "auth_rule_count": 3 },
      { "name": "developers", "auth_rule_count": 7 },
      { "name": "billing-readonly", "auth_rule_count": 2 }
    ],
    "file_version": 12,
    "etag": "a1b2c3d4e5f6"
  }
}

List services referenced in proxy config

Returns the deduplicated list of service names referenced by any permission cell or hook rule in the container’s proxy configuration. This is useful for validating that every expected service has been wired up before performing a targeted lookup.

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

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID

This endpoint takes no request body.

cURL

curl -X GET "https://api.hoody.com/api/v1/containers/507f1f77bcf86cd799439012/proxy/services" \
  -H "Authorization: Bearer <token>"

SDK

const result = await client.api.proxyDiscovery.listContainerProxyServices({
  id: "507f1f77bcf86cd799439012"
});

Response 200

{
  "statusCode": 200,
  "message": "OK",
  "data": {
    "services": ["slack-api", "github-webhook", "stripe-webhook", "internal-events"],
    "file_version": 12,
    "etag": "a1b2c3d4e5f6"
  }
}

Get merged proxy view for a service

Returns a debug-friendly merged view of the proxy configuration for a single service, including permissions_raw (per-group access cells for this service), registered hooks, the effective_default (one of allow or deny), and the is_reject_listed flag.

Caution

This endpoint is non-authoritative and intended for debugging. To read or modify authoritative rules, use the /proxy/permissions/{group} and /proxy/hooks/{service} endpoints instead.

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

Parameters

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

This endpoint takes no request body.

cURL

curl -X GET "https://api.hoody.com/api/v1/containers/507f1f77bcf86cd799439012/proxy/services/slack-api" \
  -H "Authorization: Bearer <token>"

SDK

const result = await client.api.proxyDiscovery.getContainerProxyService({
  id: "507f1f77bcf86cd799439012",
  service: "slack-api"
});

Response 200

{
  "statusCode": 200,
  "message": "OK",
  "data": {
    "service": "slack-api",
    "is_reject_listed": false,
    "permissions_raw": {
      "admins": { "allow": ["read", "write"] },
      "developers": { "allow": ["read"] }
    },
    "hooks": [
      {
        "event": "on_request",
        "action": "log_call",
        "config": { "destination": "audit-log" }
      }
    ],
    "effective_default": "deny",
    "file_version": 12,
    "etag": "a1b2c3d4e5f6"
  }
}