---
title: "Update deal won reason"
method: PUT
path: "/admin/deal_won_reasons/{id}"
tags: ["Deal won reasons"]
---

# Update deal won reason

`PUT /admin/deal_won_reasons/{id}`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/deal_won_reasons/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

## Path parameters

- `id` integer, required

## Request body

- object
  - `deal_won_reason` DealWonReasonWritable
    - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
    - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
    - `name` string: The label of this deal won reason
    - `position` integer: Position used to order the options in the app

## Response `200`

Successful Response

- DealWonReasonAll
  - `id` integer: Unique identifier
  - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
  - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
  - `name` string: The label of this deal won reason
  - `position` integer: Position used to order the options in the app

## Other responses

- `403`: The credentials are valid but this user may not perform the action (permissions, a read-only token, or API access switched off).
- `404`: No record with that id is visible to this user. Records owned by other users that you cannot see also answer 404.
- `422`: The request was understood but a value is missing, invalid or too long.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)