Delete a node Run in API Explorer

DELETE /nodes/{id}

Path parameters

  • id string Required

    The ID or name of the node

Query parameters

  • force boolean

    Force remove a node from the swarm

    Default value is false.

Responses

  • 200

    no error

  • 404 application/json

    no such node

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
  • 500 application/json

    server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
  • 503 application/json

    node is not part of a swarm

    Hide response attribute Show response attribute object
    • message string Required

      The error message.
DELETE /nodes/{id} 
curl \
 --request DELETE 'http://api.example.com/v1.49/nodes/{id}'
Response examples (404) 
{
  "message": "Something went wrong."
}
Response examples (404) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}
Response examples (500) 
{
  "message": "Something went wrong."
}
Response examples (503) 
{
  "message": "Something went wrong."
}
Response examples (503) 
{
  "message": "Something went wrong."
}