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. Follow our Attaching Documents and Images guide to upload to our third party storage provider in order to obtain
file_url
.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 obtained from our storage provider that points 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. Follow our Attaching Documents and Images guide to upload to our third party storage provider in order to obtain
file_url
.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 obtained from our storage provider that points 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"
}