REST API
SUPPORTFEEDBACK

[beta] Update a maintenance vendor

patch
https://api.samsara.com/fleet/maintenance/vendors

Updates an existing maintenance vendor for the organization. Migrating a vendor between a linked Place (addressId) and a self-contained address (address) is not supported.

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 externalIds in the response. Defaults to false.

string
required

Unique identifier for the Vendor record.

Body Params

Request body for updating a Vendor

string

Address of the vendor.

string

Linked place identifier for the vendor address.

assetAttributeSelections
array of objects

Assets this vendor can service. Empty replaces inherited selections; null clears the setting.

assetAttributeSelections
contacts
array of objects

People to contact at the vendor.

contacts
defaultLaborRatePerHour
object

VendorHourlyMoney object

emailAddresses
array of strings

Email addresses for the vendor.

emailAddresses
externalIds
array of objects

Customer-supplied external identifiers for the vendor, interchangeable with id in filters. Only included in the response when includeExternalIds is set.

externalIds
boolean

Whether this vendor provides mobile service. When unset, the profile or system default applies.

boolean

Whether this vendor location is preferred. When unset, the profile or system default applies.

string

Name of the vendor.

string

Additional notes about the vendor.

string

Free-text AP/ERP payee identifier for the vendor. Not a reference to a Samsara entity.

phoneNumbers
array of strings

Phone numbers for the vendor.

phoneNumbers
string

Description of services provided by the vendor.

string
enum

Own lifecycle status. Defaults to active. Unknown is read-only. Valid values: active, inactive, unknown

Allowed:
string

Vendor group ID. Null removes membership while preserving explicit overrides.

string

User-defined identifier for the vendor.

Responses

Updated about 1 month 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 1 month ago

Did this page help you?