Delete a stage

DELETE  https://:account.api-us1.com/api/3/dealStages/id

• cURL

curl --request DELETE \
  --url https:///:account.api-us1.com/api/3/dealStages/id

• Node

var request = require("request");

var options = { method: 'DELETE',
  url: 'https:///:account.api-us1.com/api/3/dealStages/id' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

• Ruby

require 'uri'
require 'net/http'

url = URI("https:///:account.api-us1.com/api/3/dealStages/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

• JavaScript

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https:///:account.api-us1.com/api/3/dealStages/id");

xhr.send(data);

• Python

import requests

url = "https:///:account.api-us1.com/api/3/dealStages/id"

response = requests.request("DELETE", url)

print(response.text)

 

409 Conflict

{
  "errors": [
    {
      "status": 409,
      "title": "Conflict",
      "detail": "The stage has existing deals. Please delete or move existing deals and try again."
    }
  ]
}

PATH PARAMS

id                                       REQUIRED

int32                                  Deal stage's id

 

To delete a deal stage, the following permissions are required.

• Deal permission: the user should have permission to manage deals.
• Edit Pipeline permission: the user should have permission to edit pipelines.
• Pipeline-specific permission: the user should have permission to manage the pipeline that the stage belongs to.

If the deal stage has existing deals, the request will be rejected with a HTTP response code 409. Before this deal stage can be deleted, all deals under this deal stage must be either moved to another deal stage or deleted.