nodestash
Deals

Delete a deal

Permanently deletes a deal. This action cannot be undone.

DELETE
/deals/{id}

Authorization

apiKey
AuthorizationBearer <token>

API key from your nodestash dashboard. Pass as a Bearer token in the Authorization header.

In: header

Path Parameters

id*string

Deal ID (prefixed with dl_).

Match^dl_

Response Body

application/json

application/json

application/json

curl -X DELETE "https://api.nodestash.io/v1/deals/dl_3xK8nM2qTsYvAzCeB2cD4"
Empty
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or invalid Authorization header"
  },
  "meta": {
    "request_id": "req_abc123def456"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Contact not found"
  },
  "meta": {
    "request_id": "req_abc123def456"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded"
  },
  "meta": {
    "request_id": "req_abc123def456"
  }
}

Create a new deal

Creates a new deal in the authenticated workspace. If `pipeline_id` is omitted, the workspace default pipeline is used. If `stage_id` is omitted, the first open stage of the pipeline is used. `currency` defaults to `EUR`. The `contact_id` and `company_id` (if provided) must reference existing resources in the workspace.

Get a deal

Retrieves a single deal by ID. Use the `include` parameter to embed related resources such as the linked contact, company, pipeline, or current stage.