Skip to main content
The HTTP scale API (desired) target requests a concrete replica count from your platform. Arklow clamps the request to the target’s minimum and maximum. This mode uses the shared status endpoint and authentication contract.

​
Write contract

Arklow sends:
Return a 2xx response after your platform accepts the target size. Return 409 when a previous change is still converging; Arklow treats the write as unsettled and waits before trying another change. The status endpoint should report current_replicas when available and use settled to show whether the requested count has converged.

​
Add an HTTP desired-count target

1

Prepare the API

Implement the shared status endpoint and the desired-count write endpoint.
2

Open scale targets

Go to Scale Targets, click New scale target, and select HTTP scale API (desired).
3

Enter the endpoint

Provide the public HTTPS base URL of the scale API.
4

Select authentication

Choose the HTTP Auth Headers credential containing the headers your API expects.
5

Select capacity

Choose the destination or shared pool served by this platform.
6

Set the envelope

Enter the minimum and maximum replica counts Arklow may request.
7

Save

Create the target and confirm that its first status observation matches your platform.