APISIX Control API

Use the APISIX Control API to inspect or control the runtime state of one APISIX instance. It is enabled by default at http://127.0.0.1:9090; configure apisix.enable control and apisix.control in...

Schema

Health Check

  • GET Get Health Check Information /v1/healthcheck

    Get health check information for this APISIX instance. Send traffic to initialize upstream checker targets. The listing also includes checkers exposed by enabled plugins, such as ai-proxy-multi. An empty listing, and a checker with no targets, use JSON arrays ([]). Each plugin...

  • GET List All Checkers Owned by a Resource /v1/healthcheck/{src_type}/{src_id}/checkers

    List the upstream checker and checkers exposed by enabled plugins on this resource. Returns an empty array for an existing resource without checkers. Does not follow a route's service or upstream references; query the owning resource. The Control API has no authentication and...

  • GET Get Health Status By Type and ID /v1/healthcheck/{src_type}/{src_id}

    Get the single upstream health checker for a resource. This endpoint retains an object response and returns 404 when the resource has no upstream checker, even if a plugin owns checkers. Use the /checkers subresource to list both upstream and plugin-owned checkers.

Garbage Collection

  • POST Trigger Garbage Collection /v1/gc

    Trigger a full garbage collection (GC) in the HTTP subsystem. Note that a request to this endpoint would not trigger a garbage collection in the stream subsystem because the subsystems are run in the separate Lua VM.

Route

Upstream

Service

Plugin Metadata

Plugin

Service Discovery

Server Information