publish

Update server version status

Changed on

Update the lifecycle status of a specific server version.

Requires publish or edit permission for the server namespace.

patch/v0.1/servers/{serverName}/versions/{version}/status

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Path parameters

serverNamestring required
Example:com.example%2Fmy-server

URL-encoded server name (e.g., "com.example%2Fmy-server")

versionstring required
Example:1.0.0

URL-encoded version to update

Request body

status'active' | 'deprecated' | 'deleted' required

New server lifecycle status

statusMessagestring

Optional message explaining the status change (e.g., deprecation reason)

Example request

{
  "status": "deprecated",
  "statusMessage": "Please upgrade to version 2.0.0"
}

Response

Successfully updated server status

serverServerDetail required(unresolved $ref)

Changes