View source for GDelete Specific Opportunity

== [[Mobile_API]] &#187;Remove Opportunity ==

=== Base URL ===
https://apimobile.callproof.com

=== Endpoint ===
/api/opportunities/{id}

=== Purpose ===
Deletes a specific opportunity and its related records, including linked contacts, history, personnel, and reassignment data.

=== HTTP Method ===
DELETE

=== Headers ===
{| class="wikitable"
! Header !! Required !! Description
|-
| Authorization || Yes || Bearer access token
|}

=== Security ===
* '''Yes''' – Requires Bearer Token authentication.

=== Parameters ===

==== Path Parameters ====
{| class="wikitable"
! Parameter !! Type !! Required !! Description
|-
| id || integer || Yes || Unique identifier of the opportunity to delete
|}

==== Query Parameters ====
None.

==== Request Body ====
None.

=== cURL Example for Android ===

<pre> curl --location --request DELETE 'https://apimobile.callproof.com/api/opportunities/YOUR_OPPORTUNITY_ID' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' </pre>

=== cURL Example for iOS ===

<pre> curl --location --request DELETE 'https://apimobile.callproof.com/api/opportunities/YOUR_OPPORTUNITY_ID' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' </pre>

=== Successful Response (200) ===
Indicates that the opportunity was deleted successfully.

{| class="wikitable"
! Field !! Type !! Description
|-
| clientStatusCode || integer || Status indicator for the client (for example, 200)
|-
| user_id || integer || Identifier of the authenticated user
|-
| company_id || integer || Identifier of the authenticated user’s company
|-
| message || string || Confirmation message (for example, "The selected opportunity was successfully deleted.")
|-
| uri || string || Requested resource URI
|}

=== Error Responses ===
{| class="wikitable"
! Status Code !! Meaning
|-
| 400 || Bad Request – the opportunity could not be deleted
|-
| 401 || Unauthorized – missing, invalid, or expired Bearer token
|}

* '''400''' – Invalid opportunity ID ("Opportunity Id is Invalid"), opportunity not found ("Opportunity Not Found"), or another delete error (for example, "Error while removing the Contact Opportunities").
* '''401''' – Authentication failed or the access token is missing/expired.