---
title: "DELETE /deals/{id}"
method: DELETE
path: "/deals/{id}"
tags: ["deals"]
---

# DELETE /deals/{id}

`DELETE /deals/{id}`

## Request

- Base URL: `https://api.agendor.com.br/v3`
- URL: `https://api.agendor.com.br/v3/deals/{id}`
- Auth: API key in header `Authorization`

Delete a deal by ID.

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `data` DealEntity
    - `id` integer: Deal ID.
    - `parentDealId` integer: Parent deal ID.
    - `accountId` integer: Account ID.
    - `organization` object: Related organization info.
      - `id` string: Organization ID.
      - `name` string: Display name (Nome fantasia).
      - `email` string: Contact email.
    - `person` object: Related person info.
      - `id` integer: Person ID.
      - `name` string: Person name.
      - `email` string, email: Email address.
    - `author` object: User that created this deal.
      - `accountId` integer: Account ID.
      - `id` integer: User ID.
      - `name` string: User name.
    - `dealStage` object: Stage that this deal is currently in.
      - `id` integer: Deal stage ID.
      - `name` string: Deal stage name.
      - `sequence` integer: Sequence number.
      - `funnel` object: Related funnel info.
        - `id` integer: Funnel ID.
        - `name` string: Funnel name.
    - `dealStatus` object: Status that this deal is in.
      - `id` 1 | 2 | 3: Deal status ID.
      - `name` 'Em andamento' | 'Ganho' | 'Perdido': Deal status name
    - `lossReason` object: Deal's loss reason information.
      - `id` integer: Loss reason ID.
      - `name` string: Loss reason name.
      - `description` string: Specific description of this deal's loss reason.
    - `owner` object: User that currently owns this deal.
      - `accountId` integer: Account ID.
      - `id` integer: User ID.
      - `name` string: User name.
    - `title` string: Deal title.
    - `description` string: Deal description.
    - `startTime` unknown
    - `endTime` unknown
    - `wonAt` unknown
    - `lostAt` unknown
    - `createdAt` unknown
    - `updatedAt` unknown
    - `ranking` 0 | 1 | 2 | 3 | 4 | 5: Numeric ranking.
    - `value` number, float: Monetary value.
    - `currency` object: Currency this deal is denominated in. Null means BRL.
      - `id` integer: Currency ID.
      - `isoCode` string: ISO 4217 currency code (e.g. USD).
      - `name` string: Currency name.
      - `symbol` string: Currency symbol (e.g. $).
    - `exchangeRate` number, float: Exchange rate to BRL currently applied to this deal. Null when the deal is in BRL.
    - `exchangeRateSource` 'deal' | 'closed' | 'account': Where the applied exchange rate comes from: 'deal' (manual override), 'closed' (frozen when the deal was won/lost) or 'account' (current account rate). Null when the deal is in BRL.
    - `valueInBrl` number, float: Monetary value converted to BRL. Equal to value when the deal is in BRL.
    - `products` ProductEntity[]: Associated products.
      - `id` integer: Product ID.
      - `name` string: Product name.
      - `code` string: Product code.
      - `categoryId` integer: Product category id.
      - `price` number, double: Product price.
      - `unit` string: Product unit.
      - `active` boolean: Product active.
      - `imageUrl` string: Product image URL.
      - `imageThumbUrl` string: Product image thumbnail URL.
      - `createdAt` unknown
      - `customFields` unknown
      - `description` string: Product description (HTML).
    - `products_entities` EntityProductEntity[]: Associated products with deal-specific pricing details.
      - `id` integer: Product ID.
      - `createdAt` unknown
      - `unitValue` number, double: Product creation date.
      - `quantity` number, double: Product creation date.
      - `discount` number, double: Product creation date.
      - `totalValue` number, double: Product creation date.
    - `allowedUsers` LeanUserEntity[]: Users allowed to view this deal.
      - `accountId` integer: Account ID.
      - `id` integer: User ID.
      - `name` string: User name.
    - `_email` string: Email address to which you can send a copy of emails to register them as tasks in this deal. Visit [this article]( https://ajuda.agendor.com.br/pt-BR/funcionalidades/como-gravar-e-mails-nos-historicos-do-agendor ) for more information.
    - `customFields` object: Custom fields.
    - `frozen` boolean: Whether this deal is currently frozen.
    - `freezing` object: Freeze details, present only when the deal is frozen; null otherwise.
      - `frozenAt` unknown
      - `unfreezeAt` unknown
      - `description` string: Reason description provided when freezing the deal.
      - `reason` string: Name of the freeze reason.
    - `_webUrl` string: Web platform URL.

## Changes

> 16 revisions in range; 1 not diffed.

- **2026-09-30** `913425271171`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agendor/apis/agendor-api/changes/deals/:id/delete.md)

---

[API](https://skmtc.dev/agendor/apis/agendor-api.md) - [All operations](https://skmtc.dev/agendor/apis/agendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agendor/apis/agendor-api/revisions/86c250dbf468?raw)