Traefik Discovery

Suppress or restore a single discovered route.

Changed on

This is a plain column update: the traefik_discovered_routes row-level trigger fires notify_route_table_change() on an enabled change, so the existing route_table_changes LISTEN/NOTIFY path reloads this node's route table and every other control plane node's. No manual reload here.

patch/traefik-discovery/routes/{host}/enabled

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/traefik-discovery/routes/{host}/enabled
  • Auth: HTTP bearer

Path parameters

hoststring required

Hostname of the discovered route

Request body

enabledboolean required

false suppresses the route without touching the container's labels; the row stays visible so the operator can see what was found.

Response

Updated discovered route

activeboolean required

Whether this route is currently served by the proxy.

contested_bystring[] required

Other labelled containers that claim this host and lost the collision. Non-empty means someone's container is silently not being routed.

created_atstring date-time required
enabledboolean required
hoststring required
idinteger required
inactive_reasonstring nullable

Why it isn't, when active is false.

last_seen_atstring date-time required
networkstring required
router_namestring required
target_container_idstring required
target_container_namestring required
target_host_portinteger nullable

Host-published port, used on baremetal installs where the proxy cannot resolve container names.

target_portinteger required
tlsboolean required
updated_atstring date-time required

Example response

{
  "created_at": "2026-01-01T00:00:00Z",
  "last_seen_at": "2026-01-01T00:00:00Z",
  "tls_certificate": {
    "authorized_at": "2026-01-01T00:00:00Z",
    "container_drift_detected_at": "2026-01-01T00:00:00Z",
    "imported_at": "2026-01-01T00:00:00Z"
  },
  "updated_at": "2026-01-01T00:00:00Z"
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status