PHP Client for Cloudflare API
Load Balancers

Pools

Load balancer pools owned by the authenticated user.

Load balancer pools owned by the authenticated user.

List

List the user's configured load balancer pools.

ParamTypeRequiredDefaultDescription
paramsarrayNo[]Query Parameters: `monitor`, to list only the pools using a given monitor.
php
$response = $client->user()->loadBalancers()->pools()->list([]);

Create

Create a new load balancer pool for the user.

ParamTypeRequiredDefaultDescription
valuesarrayYesValues to set on the pool, e.g. `name`, `origins`.
php
$response = $client->user()->loadBalancers()->pools()->create([]);

Get

Get a single configured load balancer pool.

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
php
$response = $client->user()->loadBalancers()->pools()->get('POOL_ID');

Update

Update an existing load balancer pool, overwriting the full configuration.

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
valuesarrayYesValues to set on the pool, e.g. `name`, `origins`.
php
$response = $client->user()->loadBalancers()->pools()->update('POOL_ID', []);

Edit

Apply changes to an existing pool, overwriting only the supplied properties.

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
valuesarrayYesValues to patch on the pool.
php
$response = $client->user()->loadBalancers()->pools()->edit('POOL_ID', []);

Bulk Edit

Apply changes to a number of existing pools, overwriting the supplied properties.

Returns the list of affected pools.

ParamTypeRequiredDefaultDescription
valuesarrayYesList of pool patches to apply, each identified by `id`.
php
$response = $client->user()->loadBalancers()->pools()->bulkEdit([]);

Delete

Delete a load balancer pool.

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
php
$response = $client->user()->loadBalancers()->pools()->delete('POOL_ID');

Health

Fetch the latest pool health status for a single pool.

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
php
$response = $client->user()->loadBalancers()->pools()->health('POOL_ID');

Preview

Preview pool health using the specified monitor and show the effective response.

Answers with a preview identifier; read the result with $client->user()->loadBalancers()->preview().

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
valuesarrayNo[]The monitor details to run the preview with.
php
$response = $client->user()->loadBalancers()->pools()->preview('POOL_ID', []);

References

List the load balancers that reference a given pool.

ParamTypeRequiredDefaultDescription
poolIdstringYesPool Identifier.
php
$response = $client->user()->loadBalancers()->pools()->references('POOL_ID');
Copyright © 2026