Skip to main content
PUT
/
api
/
services
/
{domain}
/
{service}
/
quiesce
Quiesce Service
curl --request PUT \
  --url https://api.example.com/api/services/{domain}/{service}/quiesce
{
  "200": {},
  "404": {},
  "500": {},
  "status": "<string>"
}

​
Endpoint

PUT /api/services/{domain}/{service}/quiesce

​
Path Parameters

​
domain
string
required
The domain/namespace of the service
​
service
string
required
The service name to quiesce

​
Response

​
status
string
Status message indicating the service has been quiesced

​
Examples

​
Quiesce a Service

curl -X PUT http://localhost:9481/api/services/example/hello/quiesce
Response
{
  "status": "quiesced"
}

​
Quiesce Before Restart

# Stop the service gracefully
curl -X PUT http://localhost:9481/api/services/ai/txt2img/quiesce

# Wait for in-flight requests to complete
sleep 5

# Restart with new configuration
curl -X POST http://localhost:9481/api/services/ai/txt2img/restart \
  -H "Content-Type: application/json" \
  -d '{"model": "sd-v3"}'

​
Use Cases

​
Graceful Shutdown

Stop a service while allowing in-flight requests to complete: 
curl -X PUT http://localhost:9481/api/services/data/processor/quiesce

​
Maintenance Window

Prepare services for maintenance: 
# Quiesce all services before maintenance
curl -X PUT http://localhost:9481/api/services/app/frontend/quiesce
curl -X PUT http://localhost:9481/api/services/app/backend/quiesce
curl -X PUT http://localhost:9481/api/services/app/database/quiesce

# Perform maintenance...

# Restart services
curl -X POST http://localhost:9481/api/services/app/database/restart
curl -X POST http://localhost:9481/api/services/app/backend/restart
curl -X POST http://localhost:9481/api/services/app/frontend/restart

​
Resource Cleanup

Free resources held by a service: 
curl -X PUT http://localhost:9481/api/services/ml/training/quiesce

​
Status Codes

​
200
Success
Service quiesced successfully
​
404
Not Found
Service not found
​
500
Internal Server Error
Failed to quiesce service

​
Notes

  • Graceful Shutdown: The service will stop accepting new requests but complete existing ones
  • In-Flight Requests: Ongoing method invocations are allowed to finish
  • Resource Cleanup: The service’s resources are released
  • No Auto-Restart: Quiesced services remain stopped until explicitly restarted
  • Use Restart to bring the service back online

​
Comparison: Quiesce vs Restart

OperationNew RequestsIn-Flight RequestsAuto-Restart
QuiesceRejectedAllowed to completeNo
RestartBriefly rejectedInterruptedYes

​
See Also