REST API
SUPPORTFEEDBACK

[beta] Update a maintenance estimate

patch
https://api.samsara.com/maintenance/estimates

Update eligible quote content, approve or deny through Samsara approval and UTS, or separately award an approved quote through the native work-order flow. Award assigns the vendor, converts estimate lines to work-order service tasks and preserves the financial baseline. Selecting a different quote after an existing award returns 409; award replacement remains a dashboard workflow. Approval and award require their respective authority and must be separate updates. Approval or award cannot be combined with content or external ID changes. Omitted fields remain unchanged.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Work Orders under the Work Orders category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean

Include estimate external identifiers. Defaults to false.

string
required

Estimate UUID or external ID.

Body Params

Omitted fields remain unchanged. Priced content is frozen after decision. No public optimistic-concurrency parameter is required.

string
enum

Approve or deny the current quote through Samsara approval and UTS. Omit to preserve the current status. Send approval separately from content changes and isAwarded. Valid values: approved, denied

Allowed:
externalIds
object

Estimate external identifiers. Responses include these only when includeExternalIds=true; default omitted.

boolean

Only true is writable: award an eligible approved quote using the native work-order flow, assigning its vendor, converting estimate lines to work-order service tasks and preserving its financial baseline. A different quote cannot replace an existing award through this API (409). Send award separately from content and external ID changes. Defaults to unchanged when omitted; requires separate award authority.

lineItems
array of objects
length ≤ 200

Complete set of 1 to 200 priced lines when supplied.

lineItems
string
length ≤ 4000

Notes, at most 4000 Unicode characters. PATCH null clears.

date-time

Actual quote timestamp. Omit if the source only has a date; do not invent a time or offset. PATCH null clears.

tax
object

Nonnegative amount in the organization's currency. Supported currencies: usd, gbp, cad, eur, chf, mxn. Exact decimal strings are required.

Responses

Updated about 6 hours ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 6 hours ago

Did this page help you?