Create a new part

post

https://api.remberg.de/v2/parts

Creates a new part with the provided properties. Returns the created part including its generated ID. Responds with 409 if a part with the same number already exists.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

The part's display name.

description

string

The part's description.

partNumber

string

required

The part's unique number.

unit

string

enum

The part's inventory unit. Defaults to 'piece' when omitted.

externalReference

string

The part's external reference.

price

number

The part's price per unit.

minimumStock

number

≤ 1000000

The part's minimum stock.

distributorOrganizationIds

array of strings

The internal IDs of the organizations that will be assigned as distributors to the part.

distributorOrganizationIds

distributorOrganizationNumbers

array of strings

The unique numbers of the organizations that will be assigned as distributors to the part.

distributorOrganizationNumbers

manufacturerOrganizationId

string

The internal ID of the organization that will be assigned as the manufacturer to the part.

manufacturerOrganizationNumber

string

The unique number of the organization that will be assigned as the manufacturer to the part.

relatedAssetIds

array of strings

The internal IDs of the assets that contain that part in their BOM.

relatedAssetIds

relatedAssetNumbers

array of strings

The unique numbers of the assets that contain that part in their BOM.

relatedAssetNumbers

relatedAssetTypeIds

array of strings

The internal IDs of the asset types that contain that part in their BOM.

relatedAssetTypeIds

relatedAssetTypeLabels

array of strings

The labels of the asset types that contain that part in their BOM.

relatedAssetTypeLabels

customPropertyValues

array of objects

customPropertyValues

Headers

remberg-active-site-ref

string

^s[1-9]\d*$

The site the request acts on, e.g. s2. You find it in the remberg web app URL (e.g. /s2/) or next to the site name under Settings → Sites. If your account has access to more than one site, send this header on every request; site-specific requests without it fail with 403 ACTIVE_SITE_UNAVAILABLE. With access to a single site, that site is used when the header is omitted. A site your account cannot access fails with 403 ACTIVE_SITE_UNAVAILABLE; a record that belongs to another site returns 404.

Responses

400

Bad Request

403

Forbidden

404

Not Found

409

Duplicate part number

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Resource created