# Disqualify a lead

**POST /api/v1/leads/{lead_uuid}/disqualify**

Marks the lead as dropped off, recording who, when and why. A caller with `leads:updateAll` disqualifies outright
and may omit the reason. A caller with `leads:update` on an assigned lead must give a reason and only raises a
pending request: the reason and requester are stored and `disqualified_at` stays null until a `leads:updateAll`
holder calls this endpoint again to confirm, which keeps the stored reason unless a new one is sent. A no-op when
the lead is already disqualified.


## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers

- **X-PLANNR-ACCOUNT-UUID** (string)


### Path parameters

- **lead_uuid** (string)
  The UUID of the lead.



### Body: application/json (object)

- **reason** (string)
  Why the lead dropped off. Required unless the caller has leads:updateAll.



## Responses
### 200


#### Body: application/json (object)
- **uuid** (string)

- **title** (string)

- **first_name** (string)

- **last_name** (string)

- **name** (string)

- **client_type** (string)

- **date_of_birth** (string)

- **status** (string)

- **status_changed_at** (string)

- **is_archived** (boolean)

- **is_disqualified** (boolean)

- **is_pending_disqualified** (boolean)

- **is_promoted** (boolean)

- **can_promote** (boolean)

- **can_update** (boolean)

- **can_archive** (boolean)

- **can_disqualify** (string)

- **can_assign** (boolean)

- **can_update_introducer** (boolean)

- **can_view_promoted** (boolean)

- **source** (object)

- **sub_source** (object)

- **assigned_account** (object)

- **introduced_by** (object)

- **created_by** (object)

- **archived_by** (object)

- **disqualified_by** (object)

- **promoted_by** (object)

- **client_account** (object)

- **primary_email** (object)

- **primary_phone_number** (object)

- **primary_address** (object)

- **interests** (array[object])

- **custom_fields** (array[object])

- **created_at** (string)

- **updated_at** (string)


### 403
Unauthorized

#### Body: application/json (object)
- **message** (string)
  A human-readable description of the error.


### 404
Lead belongs to another firm

#### Body: application/json (object)
- **message** (string)
  A human-readable description of the error.


### 409


#### Body: application/json (object)
- **message** (string)
  A human-readable description of the error.


### 422
Validation error

#### Body: application/json (object)
- **message** (string)
  A human-readable description of the error.

- **errors** (object)
  Validation messages keyed by the field that failed.



[Powered by Bump.sh](https://bump.sh)