Add stock to a product
Appends delivery stock to a text_pool product. Requires the products:write scope.
Send the units as one text blob; it is split on the product’s configured delimiter, trimmed, and deduplicated against the units already available or reserved. Lines that collide are reported as skippedDuplicates rather than rejected, so re-sending a batch is safe. Any other delivery type is a 400.
Authorizations
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
The product to act on. Formatted as a UUID, e.g. 3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83.
"3f1a9c2e-7b04-4d8e-9a6f-2c5b1e0d7a83"
Body
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.
1 - 5000000"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.
Units accepted into the pool by this call.
-9007199254740991 <= x <= 9007199254740991120
Units dropped because an identical one was already available or reserved. Re-sending a batch is therefore safe.
-9007199254740991 <= x <= 90071992547409915
Units now sellable in the pool, after this call.
-9007199254740991 <= x <= 9007199254740991162