Skip to main content
POST
Add stock to a product

Authorizations

Authorization
string
header
required

A store API key, sent as Authorization: Bearer <key>.

A key looks like tbrn_live_ followed by 48 hex characters, e.g. tbrn_live_4f2a...c91b. Mint one in the Taberna dashboard under Developers → API Keys, tick the scopes the integration needs, and copy it there and then — the full value is shown once and only its hash is stored, so a lost key is replaced rather than recovered.

One key belongs to one store and carries a fixed scope set. Send it from a server, never from a browser: it can create orders and invoices and read every order the store has.

Path Parameters

id
string<uuid>
required

The product to act on. Formatted as a UUID, e.g. 3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83.

Example:

"3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83"

Body

application/json
text
string
required

The new stock units as one blob, split on the product's configured delimiter (a newline, by default). Lines are trimmed, and any that duplicate a unit already available or reserved are reported as skippedDuplicates rather than rejected — so re-sending a batch is safe. Up to 5,000,000 characters, subject to the 8MB body limit.

Required string length: 1 - 5000000
Example:

"ACME-9F2K-77QX\nACME-3B1M-52TD"

Response

How many units were added, skipped as duplicates, and are now available.

The result of appending delivery stock to a text_pool product.

added
integer
required

Units accepted into the pool by this call.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

120

skippedDuplicates
integer
required

Units dropped because an identical one was already available or reserved. Re-sending a batch is therefore safe.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

5

available
integer
required

Units now sellable in the pool, after this call.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

162