Create Part

Creates a new Part

info

tire_config support is currently in private beta.

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 object

  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.

  oneOf

  • MOD1
  • MOD2

  ---

  string

  number
• upc string

  Possible values: <= 255 characters

  The Universal Product Code for this Part. Must be unique.

• custom_fields object

  *Full details on working with Custom Fields here.

Responses

• 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 integer

  Possible values: >= 1

  name string

  description string

  symbol 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

  type

  items 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"
}

Loading...