---
title: "Update an existing estimation"
method: POST
path: "/api/estimation/update"
tags: ["Estimation"]
---

# Update an existing estimation

`POST /api/estimation/update`

## Headers

- `x-auth-key` string, required
- `x-auth-secret` string, required

## Request body

- EstimationUpdateApiModel
  - `Id` integer — estimation id
  - `ClientId` integer — The client to whom this estimation is assigned
  - `ClonedFromId` integer — Indicate from which estimation this estimation has been cloned from
  - `Number` string — Unique estimation number
  - `IssuedOn` string, date-time — Indicates when the estimation was issued
  - `ExpiresOn` string, date-time — Indicates when the estimation will be proclamed as due
  - `PoNumber` string — Unique number generated by the buyer
  - `Terms` string — Terms of agreement
  - `Notes` string — Internal note regarding the estimation
  - `Status` 'Draft' | 'Accepted' | 'Rejected' — Indicate the status of the estimation (paid/unpaid/overdue)
  - `CurrencyId` integer — Id of the currency for the estimation amounts
  - `PaymentGateways` EstimationGatewayApiModel[] — List of enabled payment gateways for this estimation
    - `Name` string — Name of the payment gateway
  - `Attachments` EstimationUpdateAttachmentApiModel[] — List of estimation attachments
    - `Id` integer — Id of estimation attachment
    - `Link` string — Link to the file
    - `Size` integer — File size number in bytes
    - `Type` 'External' | 'Uploaded' — Type of the link (Attached or external)
    - `OriginalFileName` string — Name of the file
    - `ObfuscatedFileName` string — Hashed file name to avoid url wildguessing
  - `Items` EstimationUpdateItemApiModel[] — List of estimation items
    - `Id` integer — Id of estimation item
    - `WorkTypeId` integer — Work type (Name of the service)
    - `Description` string — Additional description attached to the estimation item
    - `Cost` number, double — Amount per unit
    - `Quantity` number, double — Quantity in total used for the work type
    - `DiscountPercentage` number, double — Discount percentage for the overall amount
    - `TaxId` integer — Tax applied on the item
    - `TaxPercentage` number, double — Task percentage. Ex: 18%

## Response `200`

OK

- EstimationFullDetailsApiModel
  - `Items` EstimationItemApiModel[] — List of estimation items
    - `Id` integer — Id of estimation item
    - `WorkTypeId` integer — Work type (Name of the service)
    - `Description` string — Additional description attached to the estimation item
    - `Cost` number, double — Amount per unit
    - `Quantity` number, double — Quantity in total used for the work type
    - `DiscountPercentage` number, double — Discount percentage for the overall amount
    - `TaxId` integer — Tax applied on the item
    - `TaxPercentage` number, double — Task percentage. Ex: 18%
    - `DiscountAmount` number, double — Amount that goes as a discount
    - `TaxAmount` number, double — Amount that goes to the tax
    - `SubTotalAmount` number, double — Sub-Total amount of the estimation item (Amount without tax)
    - `TotalAmount` number, double — Total amount of the estimation item
  - `Attachments` EstimationAttachmentApiModel[] — List of estimation attachments
    - `Id` integer — Id of estimation attachment
    - `Link` string — Link to the file
    - `Size` integer — File size number in bytes
    - `Type` 'External' | 'Uploaded' — Type of the link (Attached or external)
    - `OriginalFileName` string — Name of the file
    - `ObfuscatedFileName` string — Hashed file name to avoid url wildguessing
  - `Activities` EstimationActivityApiModel[] — List of estimation activities. estimation audit log
    - `Id` integer — Id of estimation activity
    - `EstimationNumber` string — Indicates to which estimation this activity refers to
    - `Type` 'Created' | 'Draft' | 'Cloned' | 'SentViaEmail' | 'SentViaSms' | 'SentReminderViaEmail' | 'SentReminderViaSms' | 'Opened' | 'Viewed' | 'Rejected' | 'Updated' | 'Paid' | 'Unpaid' | 'Overdue' | 'NewManualPayment' | 'NewPaymentWithPaypal' | 'NewPaymentWithStripe' | 'NewPaymentWithPayoneer' | 'SentToAccountant' | 'DownloadedAsPdf' | 'MarkAsPaidByTheClient' | 'OpenedAttachment' | 'NewPaymentWithSquare' | 'NewPaymentWithKlikAndPay' | 'NewPaymentWithRazorpay' | 'NewPaymentWithWepay' | 'NewPaymentWithHalkbank' | 'ChangeStatus' | 'OrderUpdated' | 'OrderCreated' | 'NewPaymentWithTwoCheckout' | 'NewPaymentWithPaymentWall' | 'NewPaymentWithBamboraEU' | 'NewPaymentWithBamboraNA' | 'Void' | 'NewPaymentWithNlb' | 'NewPaymentWithAuthorizeNet' | 'NewPaymentWithBraintree' | 'EstimationCreated' | 'EstimationDraft' | 'EstimationCloned' | 'EstimationSentViaEmail' | 'EstimationOpened' | 'EstimationViewed' | 'EstimationAccepted' | 'EstimationRejected' | 'EstimationUpdated' | 'EstimationDownloadedAsPdf' | 'InvoiceDigitallySigned' — Type of the activity
    - `Message` string — Message associated with the activity
    - `Link` string — Url which point out to a certain activity action. Ex: Click to view the payment
  - `PaymentGateways` EstimationGatewayApiModel[] — List of enabled payment gateways for this estimation
    - `Name` string — Name of the payment gateway
  - `Id` integer — Estimation id
  - `Client` ClientDetailsApiModel
    - `Id` integer — Entity id
    - `CreatedOn` string, date-time — Date of creation
    - `ClientCurrencyId` integer — Indicates the default system currency used by the user for the client
    - `ClientCountryId` integer — Indicates the country where the clients is from
    - `UiLanguageId` integer — Hold a value of the language in which the invoice will be sent
    - `Name` string — Name of the client
    - `Address` string — Client business address
    - `Email` string — Client email
    - `AdditionalEmails` AdditionalClientEmailApiModel[] — Client additional emails contact for CC
      - `Email` string — CC
    - `PhoneNumber` string — Client phone numer
    - `Vat` string — Client's VAT number
    - `CompanyRegistrationNumber` string — Client's Company Registration Number
    - `DefaultDueDateInDays` integer — Client custom payment terms
  - `Currency` CurrencyDetailsApiModel
    - `Id` integer — Entity id
    - `Name` string — Name of the country
    - `Value` string — Currency short alpha code
    - `Code` string — Currency short numeric code
    - `Symbol` string — Currency symbol
  - `ClonedFromId` integer — Indicate from which estimation this estimation has been cloned from
  - `Number` string — Unique estimation number
  - `IssuedOn` string, date-time — Indicates when the estimation was issued
  - `ExpiresOn` string, date-time — Indicates when the estimation will be proclamed as due
  - `PoNumber` string — Unique number generated by the buyer
  - `DiscountAmount` number, double — Amount that goes as a discount
  - `TaxAmount` number, double — Amount that goes to the tax
  - `SubTotalAmount` number, double — Total amount of the estimation without tax
  - `TotalAmount` number, double — Total amount of the estimation with tax
  - `Terms` string — Terms of agreement
  - `Notes` string — Internal note regarding the estimation
  - `Status` 'Draft' | 'Accepted' | 'Rejected' — Indicate the status of the estimation (paid/unpaid/overdue)
  - `AccessToken` string — Security access token used for accessing the estimation anonymously

---

[API](https://skmtc.dev/envoice/apis/api-v1-0-0.md) · [All operations](https://skmtc.dev/envoice/apis/api-v1-0-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/envoice/api-v1-0-0/revisions/e20a9e338d8f/schema)
