Version 2.0

Disable Live Deployment

POST/api/v2/models/liveDeployments/{liveDeploymentRid}/disable

Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Disables the live deployment and removes its running replicas while retaining its model and runtime configuration.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:models-write.

Path parameters

liveDeploymentRid

string

The Resource Identifier (RID) of a Live Deployment.

Query parameters

preview

booleanoptional

Enables the use of preview functionality.

Examples

Request

Copied!

curl -X POST \
\t-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/models/liveDeployments/ri.foundry-ml-live.main.live-deployment.f351c142-0e4c-4b12-adc2-6e1539737ae9/disable?preview=true"

Error responses

Error Name
`LiveDeploymentNotFound`	Error Code	`NOT_FOUND`
	Status Code	404
	Description	The specified live deployment was not found.
	Parameters	`liveDeploymentRid`
`DisableLiveDeploymentPermissionDenied`	Error Code	`PERMISSION_DENIED`
	Status Code	403
	Description	Could not disable the LiveDeployment.
	Parameters	`liveDeploymentRid`

See Errors for a general overview of errors in the platform.