Skip to navigation

Delete an opportunity status

View as Markdown

Delete an opportunity status and remove it from its pipeline. Returns an empty object on success.

Returns 400 if any opportunities still have this status, so move them to another status first. Also returns 400 if this is the organization's last opportunity status. Requires the Manage Customizations permission, otherwise returns 403.

Authentication

AuthorizationBasic
Use your API key as the username and leave the password empty.
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired
ID of the opportunity status.

Response

Successful response

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error