How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HAProxy Defaults API

Managing defaults configuration (advanced mode)

HAProxy Defaults API is one of 68 APIs that HAProxy publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Defaults. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, a GitHub repository, and a changelog.

This API exposes 6 operations across 2 paths, and defines 52 schemas. It is described by OpenAPI 3.2.0, at version 3.4.

Requests are made against a single base URL, /v3.

6 operations 2 paths 52 schemas 1 DELETE2 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.4
Base URL
http://{haproxy-host}:5555/v3
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

HAProxy Defaults API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basic_auth). By default, every request must be authenticated.

Paths & Operations 6

Across 2 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Defaults 6

Managing defaults configuration (advanced mode)

GET
/services/haproxy/configuration/defaults
Return an array of defaults
getDefaultsSections 2 params → 200default
POST
/services/haproxy/configuration/defaults
Add a defaults section
addDefaultsSection 4 params body → 201202400409default
PUT
/services/haproxy/configuration/defaultsdeprecated
Add a defaults section
createDefaultsSection 4 params body → 201202400409default
DELETE
/services/haproxy/configuration/defaults/{name}
Delete a defaults section
deleteDefaultsSection 5 params → 202204404default
GET
/services/haproxy/configuration/defaults/{name}
Return a defaults section
getDefaultsSection 3 params → 200404default
PUT
/services/haproxy/configuration/defaults/{name}
Replace a defatults section
replaceDefaultsSection 5 params body → 200202400404default

Schemas 52

The contract defines 52 schemas that model the data the API accepts and returns. The most detailed are defaults_base (114 properties), server_params (111 properties), http_request_rule (74 properties), http_response_rule (60 properties). Each schema is shown below with its type and property counts.

stats_auth
object
2 properties 2 required
forwarded
object
Controls insertion of the HTTP Forwarded header field.
12 properties 1 required
tcp_request_rules
array
HAProxy TCP request rules array (corresponds to tcp-request directive)
compression
object
10 properties
hash_type
object
3 properties
quic_initial_rules
array
acls
array
HAProxy ACL lines array (corresponds to acl directives)
acl
object
The use of Access Control Lists (ACL) provides a flexible solution to perform content switching and generally to take decisions based on content extracted from…
4 properties 2 required
balance
object
13 properties 1 required
httpchk_params
object
4 properties
http_request_rule
object
HAProxy HTTP request rule configuration (corresponds to http-request directives)
74 properties 1 required
defaults
object
Defaults with all its children resources
monitor_uri
string
forwardfor
object
4 properties 1 required
source
object
8 properties 1 required
quic_initial_rule
object
QUIC Initial configuration
4 properties 1 required
log_target
object
Per-instance logging of events and traffic.
12 properties
pgsql_check_params
object
1 property
stats_http_request
object
4 properties 1 required
email_alert
object
Send emails for important log messages.
6 properties 3 required
tcp_response_rules
array
HAProxy TCP response rules array (corresponds to tcp-response directive)
log_targets
array
HAProxy log target array (corresponds to log directives)
errorfile
object
2 properties
http_checks
array
error
object
API Error
2 properties 2 required
server_params
object
111 properties
return_header
object
2 properties 2 required
use_small_buffers
object
Enables support for small buffers for the given categories.
4 properties 1 required
http_request_rules
array
HAProxy HTTP request rules array (corresponds to http-request directives)
redispatch
object
2 properties 1 required
mysql_check_params
object
2 properties
errorfiles
object
3 properties
tcp_response_rule
object
HAProxy TCP Response Rule configuration (corresponds to tcp-response)
27 properties 1 required
errorloc
object
3 properties 2 required
persist_rule
object
2 properties 1 required
http_check
object
35 properties 1 required
cookie
object
13 properties 1 required
defaults_sections
array
HAProxy defaults sections array
http_after_response_rule
object
HAProxy HTTP after response rule configuration (corresponds to http-after-response directives)
31 properties 1 required
http_response_rule
object
HAProxy HTTP response rule configuration (corresponds to http-response directives)
60 properties 1 required
http_error_rule
object
HAProxy HTTP error rule configuration (corresponds to http-error directives)
7 properties 2 required
tcp_request_rule
object
HAProxy TCP Request Rule configuration (corresponds to tcp-request)
38 properties 1 required
default_server
http_after_response_rules
array
HAProxy HTTP after response rules array (corresponds to http-after-response directives)
http_error_rules
array
HAProxy HTTP error rules array (corresponds to http-error directives)
tcp_checks
array
smtpchk_params
object
2 properties
http_response_rules
array
HAProxy HTTP response rules array (corresponds to http-response directives)
defaults_base
object
HAProxy defaults configuration
114 properties 1 required
stats_options
object
17 properties
originalto
object
3 properties 1 required
tcp_check
object
32 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

haproxy-defaults-api-openapi.yml Raw ↑

Other APIs HAProxy publishes across the network.

HAProxy Runtime API
HAProxy Kubernetes Ingress Controller
HAProxy ACL API
HAProxy ACL Runtime API
HAProxy Acme API
HAProxy Acme Runtime API
HAProxy Backend API
HAProxy Backend Switching Rule API
HAProxy Bind API
HAProxy Cache API
HAProxy Configuration API
HAProxy Crt Load API
Where this information came from

This is an independent, third-party profile of HAProxy Defaults API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.