Create Part
Creates a new Part
- application/json
Request Body
- description string
- manufacturer_part_number string
Possible values:
<= 255 characters
The part number from this Part's manufacturer.
- measurement_unit_id integer
Possible values:
>= 1
- measurement_unit_name string
The name of the measurement unit. If the measurement unit does not exist, it will be ignored.
- number string required
Possible values:
<= 255 characters
The part number to be used for this Part within Fleetio. Must be unique. Does not have to be the same as the manufacturer's part number.
- part_category_id integer
Possible values:
>= 1
- part_category_name string
Possible values:
<= 255 characters
The name of the part category. If the part category does not exist, it will be created.
- part_manufacturer_id integer
Possible values:
>= 1
- part_manufacturer_name string
Possible values:
<= 255 characters
The name of the part manufacturer. If the part manufacturer does not exist, it will be created.
- unit_cost number
The cost per unit of this Part, which will be interpreted as dollars, or dollars and cents. May be sent as a string, integer, or float. Value may be up to two decimal places.
- upc string
Possible values:
<= 255 characters
The Universal Product Code for this Part. Must be unique.
tire_config_attributes object
infotire_config_attributes
are available to accounts on Premium plansParts that have a Part Category where
tire_category
istrue
can have a TireConfg which are tire-specific Part attributes.aspect_ratio floatAspect ratio of tire.
rim_diameter floatRim diameter of tire.
load_index floatLoad index of tire.
metric_type stringPossible values: [
EU
,P
,HL
,T
,LT
,C
,ST
]Metric type of tire.
width floatWidth of tire.
construction stringPossible values: [
B
,R
,D
]Construction type of tire.
speed_rating stringPossible values: [
A1
,A2
,A3
,A4
,A5
,A6
,A7
,A8
,B
,C
,D
,E
,F
,G
,H
,J
,K
,L
,M
,N
,P
,Q
,R
,S
,T
,U
,V
,W
,Y
]Speed rating of tire.
factory_tread_depth floatfactory_tread_depth support is currently in private beta.
Tread depth of tire in /32" when new, as specified by the manufacturer.
minimum_tread_depth floatminimum_tread_depth support is currently in private beta.
The legal minimum tread depth, in /32".
life_expectancy integerlife_expectancy support is currently in private beta.
The Life Expectancy or “Warranty” of a tire is the expected meter range, usually measured in miles, of a given tire as specified by the manufacturer.
- custom_fields object
*Full details on working with Custom Fields here.
documents_attributes object[]
An array of one or more document objects to add to the record. You may provide your own
file_url
, or follow our Attaching Documents and Images guide to upload to our third party storage provider.name stringPossible values:
<= 255 characters
The name to give the file which will be shown in the UI.
file_url stringPossible values:
<= 255 characters
The URL pointing to the file.
file_mime_type stringPossible values:
<= 255 characters
The MIME type of the file. For example,
application/pdf
.file_name stringPossible values:
<= 255 characters
The name of the file.
file_size integerThe size of the file in bytes.
images_attributes object[]
An array of one or more image objects to add to the record. You may provide your own
file_url
, or follow our Attaching Documents and Images guide to upload to our third party storage provider.name stringPossible values:
<= 255 characters
The name to give the image which will be shown in the UI.
file_url stringPossible values:
<= 255 characters
The URL pointing to the image.
file_mime_type stringPossible values:
<= 255 characters
The MIME type of the image. For example,
image/png
.file_name stringPossible values:
<= 255 characters
The name of the image.
file_size integerThe size of the image file in bytes.
- 201
- 401
- 403
- 422
- 500
OK
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
- id integer
Possible values:
>= 1
- created_at date-time
The date and time at which this record was created.
- updated_at date-time
The date and time at which this record was most recently updated.
- account_id integer
Possible values:
>= 1
- description string
A description of this Part.
- manufacturer_part_number string
The part number from this Part's manufaturer.
- measurement_unit_id NullableId
Possible values:
>= 1
- number string
A unique number for this Part. Does not have to be the same as the manufacturer's number.
- part_category_id NullableId
Possible values:
>= 1
- part_manufacturer_id NullableId
Possible values:
>= 1
- upc string
The Universal Product Code for this Part.
- custom_fields object
*Full details on working with Custom Fields here.
- unit_cost_cents integer
The unit cost for this Part in cents.
- average_unit_cost_cents integer
The average unit cost for this Part in cents.
- images_count integer
The number of images attached to this Part.
- documents_count integer
The number of documents attached to this Part.
- comments_count integer
The number of
Comments
attached to this Part. - archived_at date-time
The date and time at which this Part was archived.
measurement_unit object
id integerPossible values:
>= 1
name stringdescription stringsymbol string- has_active_inventory_sets boolean
Indicates whether this Part has any active Inventory Sets.
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"account_id": 0,
"description": "string",
"manufacturer_part_number": "string",
"measurement_unit_id": 0,
"number": "string",
"part_category_id": 0,
"part_manufacturer_id": 0,
"upc": "string",
"custom_fields": {},
"unit_cost_cents": 0,
"average_unit_cost_cents": 0,
"images_count": 0,
"documents_count": 0,
"comments_count": 0,
"archived_at": "2023-03-14T13:46:27-06:00",
"measurement_unit": {
"id": 0,
"name": "string",
"description": "string",
"symbol": "string"
},
"has_active_inventory_sets": true
}
Request could not be authenticated
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Insufficient permission to perform this operation
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Unprocessable Entity
- application/json
- Schema
- Example (from schema)
- Example
Schema
errors object
typeitems string
{
"errors": {}
}
{
"errors": {
"field1": [
"error1",
"error2"
],
"field2": [
"error3"
]
}
}
Something unexpected happened
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}