COcomposal
hosting

PUT /api/v1/hosting/apps/{app_id}/service_placements/configure

Request

  • Base URL
    https://composal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://composal.com/api/v1/hosting/apps/{app_id}/service_placements/configure
  • Auth
    HTTP bearer

Path parameters

app_idstring required

Request body

app_service_idstring required
app_environment_idstring required
expected_generationinteger

Required for preview environments. Stale generations or unfinished cleanup return 409.

mode'single_region' | 'multi_region' required
rollout_strategy'health_gated' | 'burst' required
deployment_channel'stable' | 'blue_green' nullable

Preview-only override; null inherits the captured source channel.

replicas_per_regioninteger required

Response

Configured service placement

Changes

No recorded changes to this operation across all 4 revisions of this API.