The Peer API from HAProxy — 2 operation(s) for peer.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/haproxy-peer-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: HAProxy Data Plane Peer API
description: 'API for editing and managing haproxy instances. Provides process information, configuration management,
haproxy stats and logs.'
version: '3.4'
contact:
name: HAProxy Support
url: https://my.haproxy.com/portal/cust/login
email: support@haproxy.com
servers:
- url: /v3
security:
- basic_auth: []
tags:
- name: Peer
paths:
/services/haproxy/configuration/peer_section:
get:
description: Returns an array of all configured peer_section.
operationId: getPeerSections
parameters:
- $ref: '#/components/parameters/transaction_id'
- $ref: '#/components/parameters/full_section'
responses:
'200':
description: Successful operation
headers:
Configuration-Version:
description: Configuration file version
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/peer_sections'
default:
$ref: '#/components/responses/DefaultError'
summary: Return an array of peer_section
tags:
- Peer
post:
description: Adds a new peer to the configuration file.
operationId: createPeer
parameters:
- $ref: '#/components/parameters/transaction_id'
- $ref: '#/components/parameters/version'
- $ref: '#/components/parameters/force_reload'
- $ref: '#/components/parameters/full_section'
responses:
'201':
description: Peer created
content:
application/json:
schema:
$ref: '#/components/schemas/peer_section'
'202':
description: Configuration change accepted and reload requested
headers:
Reload-ID:
description: ID of the requested reload
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/peer_section'
'400':
$ref: '#/components/responses/BadRequest'
'409':
$ref: '#/components/responses/AlreadyExists'
default:
$ref: '#/components/responses/DefaultError'
summary: Add a peer
tags:
- Peer
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/peer_section'
required: true
/services/haproxy/configuration/peer_section/{name}:
delete:
description: Deletes a peer from the configuration by it's name.
operationId: deletePeer
parameters:
- description: Peer name
in: path
name: name
required: true
schema:
type: string
- $ref: '#/components/parameters/transaction_id'
- $ref: '#/components/parameters/version'
- $ref: '#/components/parameters/force_reload'
responses:
'202':
description: Configuration change accepted and reload requested
headers:
Reload-ID:
description: ID of the requested reload
schema:
type: string
'204':
description: Peer deleted
'404':
$ref: '#/components/responses/NotFound'
default:
$ref: '#/components/responses/DefaultError'
summary: Delete a peer
tags:
- Peer
get:
description: Returns one peer configuration by it's name.
operationId: getPeerSection
parameters:
- description: Peer name
in: path
name: name
required: true
schema:
type: string
- $ref: '#/components/parameters/transaction_id'
- $ref: '#/components/parameters/full_section'
responses:
'200':
description: Successful operation
headers:
Configuration-Version:
description: Configuration file version
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/peer_section'
'404':
$ref: '#/components/responses/NotFound'
default:
$ref: '#/components/responses/DefaultError'
summary: Return a peer
tags:
- Peer
components:
parameters:
version:
name: version
in: query
description: Version used for checking configuration version. Cannot be used when transaction is specified, transaction has it's own version.
required: false
schema:
type: integer
force_reload:
name: force_reload
in: query
description: If set, do a force reload, do not wait for the configured reload-delay. Cannot be used when transaction is specified, as changes in transaction are not applied directly to configuration.
required: false
schema:
type: boolean
default: false
full_section:
name: full_section
in: query
description: Indicates if the action affects the specified child resources as well
required: false
schema:
type: boolean
default: false
transaction_id:
name: transaction_id
in: query
description: ID of the transaction where we want to add the operation. Cannot be used when version is specified.
required: false
schema:
type: string
schemas:
table:
properties:
expire:
pattern: ^\d+(ms|s|m|h|d)?$
type:
- string
- 'null'
x-default-unit: ms
x-duration: true
metadata:
additionalProperties:
type: object
name:
type: string
no_purge:
type: boolean
x-display-name: No Purge
recv_only:
type: boolean
x-display-name: Receive Only
size:
pattern: ^\d+(k|K|m|M|g|G)?$
type: string
x-size: true
store:
type: string
type:
enum:
- ip
- integer
- string
- binary
type: string
type_len:
type:
- integer
- 'null'
x-display-name: Type
write_to:
type:
- string
- 'null'
required:
- name
type: object
server_params:
properties:
agent-addr:
pattern: ^[^\s]+$
type: string
agent-check:
enum:
- enabled
- disabled
type: string
x-dependency:
agent-port:
required: true
agent-inter:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
agent-port:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
agent-send:
type: string
allow_0rtt:
type: boolean
alpn:
pattern: ^[^\s]+$
type: string
x-display-name: ALPN Protocols
backup:
enum:
- enabled
- disabled
type: string
cc:
type: string
x-display-name: TCP Congestion Control Algorithm
check:
enum:
- enabled
- disabled
type: string
check-pool-conn-name:
pattern: ^[^\s]+$
type: string
check-reuse-pool:
enum:
- enabled
- disabled
type: string
check-send-proxy:
enum:
- enabled
- disabled
type: string
check-sni:
pattern: ^[^\s]+$
type: string
check-ssl:
enum:
- enabled
- disabled
type: string
check_alpn:
pattern: ^[^\s]+$
type: string
x-display-name: Protocols
check_proto:
pattern: ^[^\s]+$
type: string
x-display-name: Name
check_sni_auto:
enum:
- enabled
- disabled
type: string
check_via_socks4:
enum:
- enabled
- disabled
type: string
ciphers:
type: string
x-dependency:
ssl:
value: enabled
ciphersuites:
type: string
x-dependency:
ssl:
value: enabled
client_sigalgs:
type: string
x-dependency:
ssl:
value: true
cookie:
pattern: ^[^\s]+$
type: string
crl_file:
type: string
x-dependency:
ssl:
value: enabled
curves:
type: string
x-dependency:
ssl:
value: true
downinter:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
error_limit:
type: integer
x-display-name: Error count
fall:
type:
- integer
- 'null'
x-display-name: Nr. of consecutive failed checks
fastinter:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
force_sslv3:
description: This field is deprecated in favor of sslv3, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
force_tlsv10:
description: This field is deprecated in favor of tlsv10, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
force_tlsv11:
description: This field is deprecated in favor of tlsv11, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
force_tlsv12:
description: This field is deprecated in favor of tlsv12, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
force_tlsv13:
description: This field is deprecated in favor of tlsv13, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
guid:
pattern: ^[A-Za-z0-9-_.:]+$
type: string
hash_key:
pattern: ^[^\s]+$
type: string
health_check_address:
pattern: ^[^\s]+$
type: string
health_check_port:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
idle_ping:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
init-addr:
pattern: ^[^\s]+$
type:
- string
- 'null'
init-state:
enum:
- fully-up
- up
- down
- fully-down
type: string
inter:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
ktls:
enum:
- 'on'
- 'off'
type: string
x-display-name: 'Enables or disables ktls for those sockets. If enabled, kTLS will be used if the kernel supports it and the cipher is compatible.
This is only available on Linux kernel 4.17 and above.
EXPERIMENTAL OPTION.'
log-bufsize:
type:
- integer
- 'null'
log_proto:
enum:
- legacy
- octet-count
type: string
maintenance:
enum:
- enabled
- disabled
type: string
max_reuse:
type:
- integer
- 'null'
maxconn:
type:
- integer
- 'null'
x-display-name: Max Concurrent Connections
maxqueue:
type:
- integer
- 'null'
x-display-name: Max Number of Connections
minconn:
type:
- integer
- 'null'
namespace:
type: string
no_sslv3:
description: This field is deprecated in favor of sslv3, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
no_tlsv10:
description: This field is deprecated in favor of tlsv10, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
no_tlsv11:
description: This field is deprecated in favor of tlsv11, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
no_tlsv12:
description: This field is deprecated in favor of tlsv12, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
no_tlsv13:
description: This field is deprecated in favor of force_tlsv13, and will be removed in a future release
enum:
- enabled
- disabled
type: string
x-deprecated: true
no_verifyhost:
enum:
- enabled
- disabled
type: string
npn:
type: string
x-dependency:
ssl:
value: enabled
observe:
enum:
- layer4
- layer7
type: string
x-dependency:
ssl:
value: enabled
on-error:
enum:
- fastinter
- fail-check
- sudden-death
- mark-down
type: string
on-marked-down:
enum:
- shutdown-sessions
type: string
on-marked-up:
enum:
- shutdown-backup-sessions
type: string
pool_conn_name:
pattern: ^[^\s]+$
type: string
pool_low_conn:
type:
- integer
- 'null'
pool_max_conn:
type:
- integer
- 'null'
pool_purge_delay:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
proto:
pattern: ^[^\s]+$
type: string
proxy-v2-options:
items:
enum:
- authority
- cert-cn
- cert-key
- cert-sig
- crc32c
- ssl
- ssl-cipher
- unique-id
type: string
type: array
x-omitempty: true
quic-cc-algo:
enum:
- cubic
- newreno
- bbr
- nocc
type: string
quic_cc_algo_max_window:
maximum: 4194304
minimum: 10
type:
- integer
- 'null'
x-default-unit: k
x-dependency:
quic-cc-algo: null
x-size: true
redir:
type: string
x-display-name: Prefix
renegotiate:
description: Toggles the secure renegotiation mechanism for an SSL backend.
enum:
- enabled
- disabled
type: string
resolve-net:
pattern: ^([A-Za-z0-9.:/]+)(,[A-Za-z0-9.:/]+)*$
type: string
resolve-prefer:
enum:
- ipv4
- ipv6
type: string
resolve_opts:
pattern: ^(allow-dup-ip|ignore-weight|prevent-dup-ip)(,(allow-dup-ip|ignore-weight|prevent-dup-ip))*$
type: string
resolvers:
pattern: ^[^\s]+$
type: string
x-dynamic-enum:
operation: getResolvers
property: name
rise:
type:
- integer
- 'null'
send-proxy:
enum:
- enabled
- disabled
type: string
send-proxy-v2:
enum:
- enabled
- disabled
type: string
send_proxy_v2_ssl:
enum:
- enabled
- disabled
type: string
send_proxy_v2_ssl_cn:
enum:
- enabled
- disabled
type: string
set-proxy-v2-tlv-fmt:
properties:
id:
type: string
value:
type: string
required:
- id
- value
type: object
shard:
type: integer
sigalgs:
type: string
x-dependency:
ssl:
value: true
slowstart:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
sni:
pattern: ^[^\s]+$
type: string
sni_auto:
enum:
- enabled
- disabled
type: string
socks4:
pattern: ^[^\s]+$
type: string
x-dependency:
check-via-socks4:
required: true
source:
type: string
ssl:
enum:
- enabled
- disabled
type: string
ssl_cafile:
pattern: ^[^\s]+$
type: string
x-dependency:
ssl:
value: enabled
x-display-name: SSL CA File
ssl_certificate:
pattern: ^[^\s]+$
type: string
x-dependency:
ssl:
value: enabled
ssl_max_ver:
enum:
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
type: string
ssl_min_ver:
enum:
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
type: string
ssl_reuse:
enum:
- enabled
- disabled
type: string
sslv3:
enum:
- enabled
- disabled
type: string
stick:
enum:
- enabled
- disabled
type: string
strict-maxconn:
type: boolean
tcp_md5sig:
pattern: ^[^\s]+$
type: string
tcp_ut:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
tfo:
enum:
- enabled
- disabled
type: string
tls_tickets:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: enabled
tlsv10:
enum:
- enabled
- disabled
type: string
tlsv11:
enum:
- enabled
- disabled
type: string
tlsv12:
enum:
- enabled
- disabled
type: string
tlsv13:
enum:
- enabled
- disabled
type: string
track:
type: string
verify:
enum:
- none
- required
type: string
x-dependency:
ssl:
value: enabled
verifyhost:
type: string
x-dependency:
ssl:
value: enabled
verify:
value: required
weight:
type:
- integer
- 'null'
ws:
enum:
- auto
- h1
- h2
type: string
x-display-name: Relaying websocket stream protocol
type: object
peer_section_base:
additionalProperties: false
description: HAProxy peer_section configuration
properties:
default_bind:
$ref: '#/components/schemas/default_bind'
default_server:
$ref: '#/components/schemas/default_server'
disabled:
type: boolean
enabled:
type: boolean
metadata:
additionalProperties:
type: object
name:
pattern: ^[A-Za-z0-9-_.:]+$
type: string
shards:
description: 'In some configurations, one would like to distribute the stick-table contents
to some peers in place of sending all the stick-table contents to each peer
declared in the "peers" section. In such cases, "shards" specifies the
number of peer involved in this stick-table contents distribution.'
type: integer
required:
- name
title: Peer Section Base
type: object
default_server:
allOf:
- $ref: '#/components/schemas/server_params'
title: Default Server
error:
additionalProperties:
type: string
description: API Error
properties:
code:
type:
- integer
- 'null'
message:
type:
- string
- 'null'
required:
- code
- message
title: Error
type: object
peer_sections:
title: Peer_Section
description: HAProxy peer_section array
type: array
items:
$ref: '#/components/schemas/peer_section'
peer_entry:
description: Peer Entry from peers table
properties:
address:
pattern: ^[^\s]+$
type: string
metadata:
additionalProperties:
type: object
name:
pattern: ^[A-Za-z0-9-_.:${}"]+$
type: string
port:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
shard:
type: integer
required:
- name
- address
- port
title: Peer Entry
type: object
bind_params:
additionalProperties: false
properties:
accept_netscaler_cip:
type: integer
accept_proxy:
type: boolean
allow_0rtt:
type: boolean
alpn:
pattern: ^[^\s]+$
type: string
x-display-name: ALPN Protocols
backlog:
type: string
ca_ignore_err:
type: string
x-dependency:
ssl:
value: true
ca_sign_file:
type: string
x-dependency:
ssl:
value: true
ca_sign_pass:
type: string
x-dependency:
ssl:
value: true
x-display-name: Passphrase
ca_verify_file:
type: string
x-dependency:
ca_file:
value: true
cc:
type: string
x-display-name: TCP Congestion Control Algorithm
ciphers:
type: string
x-dependency:
ssl:
value: true
ciphersuites:
type: string
x-dependency:
ssl:
value: true
client_sigalgs:
type: string
x-dependency:
ssl:
value: true
crl_file:
type: string
x-dependency:
ssl:
value: true
crt_ignore_err:
type: string
x-dependency:
ssl:
value: true
crt_list:
type: string
x-dependency:
ssl:
value: true
curves:
type: string
x-dependency:
ssl:
value: true
default_crt_list:
items:
pattern: ^[^\s]+$
type: string
type: array
x-omitempty: true
defer_accept:
type: boolean
ecdhe:
type: string
x-dependency:
ssl:
value: true
expose_fd_listeners:
type: boolean
force_sslv3:
description: This field is deprecated in favor of sslv3, and will be removed in a future release
type: boolean
x-deprecated: true
force_strict_sni:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
force_tlsv10:
description: This field is deprecated in favor of tlsv10, and will be removed in a future release
type: boolean
x-deprecated: true
force_tlsv11:
description: This field is deprecated in favor of tlsv11, and will be removed in a future release
type: boolean
x-deprecated: true
force_tlsv12:
description: This field is deprecated in favor of tlsv12, and will be removed in a future release
type: boolean
x-deprecated: true
force_tlsv13:
description: This field is deprecated in favor of tlsv13, and will be removed in a future release
type: boolean
x-deprecated: true
generate_certificates:
type: boolean
x-dependency:
ssl:
value: true
gid:
type: integer
x-display-name: Group ID
group:
type: string
x-display-name: Group name
guid_prefix:
pattern: ^[A-Za-z0-9-_.:]+$
type: string
id:
type: string
x-display-name: Socket ID
idle_ping:
minimum: 0
type:
- integer
- 'null'
x-default-unit: ms
x-duration: true
interface:
type: string
ktls:
enum:
- 'on'
- 'off'
type: string
x-display-name: 'Enables or disables ktls for those sockets. If enabled, kTLS will be used if the kernel supports it and the cipher is compatible.
This is only available on Linux kernel 4.17 and above.
EXPERIMENTAL OPTION.'
label:
type: string
level:
enum:
- user
- operator
- admin
example: user
type: string
maxconn:
example: 1234
type: integer
mode:
type: string
mss:
type: string
namespace:
example: app
type: string
nbconn:
type: integer
x-display-name: Number of connection
nice:
example: 1
type: integer
no_alpn:
type: boolean
x-dependency:
ssl:
value: true
no_ca_names:
type: boolean
x-dependency:
ssl:
value: true
no_sslv3:
description: This field is deprecated in favor of sslv3, and will be removed in a future release
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
no_strict_sni:
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
no_tls_tickets:
description: This field is deprecated in favor of tls_tickets, and will be removed in a future release
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
no_tlsv10:
description: This field is deprecated in favor of tlsv10, and will be removed in a future release
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
no_tlsv11:
description: This field is deprecated in favor of tlsv11, and will be removed in a future release
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
no_tlsv12:
description: This field is deprecated in favor of tlsv12, and will be removed in a future release
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
no_tlsv13:
description: This field is deprecated in favor of tlsv13, and will be removed in a future release
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
npn:
type: string
prefer_client_ciphers:
type: boolean
proto:
type: string
x-display-name: Protocol name
quic-cc-algo:
enum:
- cubic
- newreno
- bbr
- nocc
type: string
quic-force-retry:
type: boolean
quic-socket:
enum:
- connection
- listener
type: string
quic_cc_algo_burst_size:
maximum: 1024
minimum: 0
type:
- integer
- 'null'
x-dependency:
quic-cc-algo: null
quic_cc_algo_max_window:
maximum: 4194304
minimum: 10
type:
- integer
- 'null'
x-default-unit: k
x-dependency:
quic-cc-algo: null
x-size: true
severity_output:
enum:
- none
- number
- string
example: none
type: string
x-display-name: Format
shards:
pattern: ^(by-thread|by-group|[0-9]+)$
type: string
x-display-name: Shards
sigalgs:
type: string
x-dependency:
ssl:
value: true
ssl:
type: boolean
ssl_cafile:
pattern: ^[^\s]+$
type: string
x-dependency:
ssl:
value: true
x-display-name: SSL CA File
ssl_certificate:
description: All of the certificates delimited by ':' as mentioned as a crt on the bind line.
pattern: ^[^\s]+$
type: string
x-dependency:
ssl:
value: true
ssl_max_ver:
enum:
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
type: string
ssl_min_ver:
enum:
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
type: string
sslv3:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
strict_sni:
type: boolean
x-dependency:
ssl:
value: true
x-deprecated: true
tcp_md5sig:
pattern: ^[^\s]+$
type: string
tcp_ss:
description: Sets the TCP Save SYN option for all incoming connections instantiated from this listening socket
enum:
- 1
- 2
- 3
type: integer
tcp_user_timeout:
type:
- integer
- 'null'
tfo:
type: boolean
thread:
type: string
tls_ticket_keys:
type: string
tls_tickets:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
tlsv10:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
tlsv11:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
tlsv12:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
tlsv13:
enum:
- enabled
- disabled
type: string
x-dependency:
ssl:
value: true
transparent:
type: boolean
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/haproxy/refs/heads/main/openapi/haproxy-peer-api-openapi.yml