Products

Create a product.

Create a product. The category template is resolved automatically from the category slug — must match a seeded category. model strings are unique within the workspace.

post/api/v1/products

Request

  • Base URL: https://app.tracepass.eu
  • URL: https://app.tracepass.eu/api/v1/products
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.tracepass.eu/api/oauth/authorize, token URL https://app.tracepass.eu/api/oauth/token, scopes: passports:write)

Headers

Idempotency-Keystring

UUID v4 (or any opaque string ≤ 64 chars) per logical operation. The platform stores the first response for 24 hours and replays it on the same key + same workspace. Reusing the same key with a different request body returns 422.

Request body

namestring required
modelstring required

Unique within the workspace.

categorystring required

Seeded category slug — batteries, textiles, jewelry, electronics, furniture, detergents, paints-coatings, packaging, toys, fmcg, tyres, iron-steel, construction.

descriptionstring
defaultFieldValuesobject

Seed values for passports created from this product, keyed by template field. Each value is checked against the template: a numeric string for a number field is stored as a number, and any other value the template rejects answers 400 Invalid default field values with details (in a batch, that item's result is an error).

imageUrlsstring[]
sourceLocalestring

Response

Product created.

_idstring

MongoDB ObjectId hex string (24 chars).

namestring
modelstring
categorystring
templateIdstring

MongoDB ObjectId hex string (24 chars).

defaultFieldValuesobject

Seed values for passports created from this product, keyed by template field. Each value is checked against the template: a numeric string for a number field is stored as a number, and any other value the template rejects answers 400 Invalid default field values with details (in a batch, that item's result is an error).

imageUrlsstring[]
passportCountinteger
status'active' | 'archived'
sourceLocalestring
createdAtstring date-time
updatedAtstring date-time

Example response

{
  "_id": "6650a1b2c3d4e5f6a7b8c9d0",
  "templateId": "6650a1b2c3d4e5f6a7b8c9d0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.