Coolify Octri Demo
POST/services/{uuid}/clone

Clone a service

Creates a clone of a service at a destination owned by the authenticated user's team. Provide destination_uuid and, if needed, a name; set clone_volumes to true only when the token has deploy ability.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
uuidstringrequired
The UUID of the service to clone.

Configuration for cloning the service to a destination. destination_uuid is required.

clone_volumesbooleanoptional
Whether to clone volume data. Needs the deploy ability.
Default:false
destination_uuidstringrequired
The UUID of the destination for the cloned service.
namestringoptional
The name for the cloned service; may be null.

6 status codes
201Returns confirmation that the service was cloned.
400Returned when the token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
403Returned when the token lacks deploy ability to clone volume data.
404Returned when a required resource is not found.
messagestringoptional
422Returned when request validation fails.
errorsobjectoptional
messagestringoptional

Error handling

A 400 indicates an invalid token, and a 401 indicates that the request is unauthenticated. A 403 is returned when clone_volumes is true but the token lacks deploy ability; a 404 indicates that a required resource was not found, and a 422 indicates validation failed. The uuid path parameter must identify the service, and destination_uuid is required.