Restock a supply

This method allows a TEOS user to increase the available amount of an existing supply by adding additional sparks. The restocked amount is added to the RemainingAmount of the supply, making more units available for trades or warp executions.

📘 Learn more about supplies.

Request Endpoint

POST
/odata/v1.0/Supplies({key})/Restock

Preconditions:

• The supply must exist.

• The supply must not be expired or deleted.

Sample value of message

POST /Supplies('0x1EAEFD42D684567ABDC7000193A96C4653DE1314DB20000167242CB20000024E')/Restock

Content-Type: application/json

{
  "additionalAmount": "10000"
}

Parameters

Name	Description	Mandatory
key	The identifier of the supply to restock	✅

Request body

application/json

Field	Type	Description	Mandatory
additionalAmount	string	Number of additional sparks to add to the supply	✅

Media type application/json

Example Response Value

{
  "Id": "C0D34D73-6FD3-40F2-A7E1-08D9412448F7",
  "State": "3",
  "BlockchainTransactionId": "0x748ac47e7226cae0e4e13373375f33ab9e4d43ef29d85d233162a7e7e913703b",
  "CorrelationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Type": "ActivateAsset",
  "OnCreated": "2025-10-08T10:20:23.027Z",
  "OnUpdated": "2025-10-08T10:20:23.027Z",
  "OnSubmitted": "2025-10-08T10:20:23.027Z",
  "OnCommitted": "2025-10-08T10:20:23.027Z",
  "OnConfirmed": "2025-10-08T10:20:23.027Z",
  "OnRevokedByBlockchain": "2025-10-08T10:20:23.027Z",
  "OnRevokedByUser": "2025-10-08T10:20:23.027Z",
  "OnRevokedByTxServer": "2025-10-08T10:20:23.027Z",
  "SignedBy": "string",
  "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "GasPrice": "string",
  "GasUsed": "string",
  "DataAsJson": "string",
  "SigningParametersAsJson": "string"
}

Response Fields Description

Field	Type	Description
Id	string	Identifier of the transaction
State	string	Current state of the transaction
BlockchainTransactionId	string	ID of the transaction on blockchain
CorrelationId	string	Correlation identifier for tracking
Type	string	Type of the transaction
OnCreated	datetime	Timestamp when the transaction was created
OnUpdated	datetime	Timestamp when the transaction was last updated
OnSubmitted	datetime	Timestamp when the transaction was submitted
OnCommitted	datetime	Timestamp when the transaction was committed
OnConfirmed	datetime	Timestamp when the transaction was confirmed
OnRevokedByBlockchain	datetime	Timestamp if transaction was revoked by blockchain
OnRevokedByUser	datetime	Timestamp if transaction was revoked by user
OnRevokedByTxServer	datetime	Timestamp if transaction was revoked by transaction server
SignedBy	string	Address or identifier of the signer
CreatedBy	string	Identifier of the creator of the transaction
GasPrice	string	Gas price used in blockchain transaction
GasUsed	string	Gas consumed for transaction execution
DataAsJson	string	Additional data in JSON format
SigningParametersAsJson	string	Signing parameters in JSON format

Responses

Code	Description
201	The transaction was successfully created
202	Accepted
400	The supply restock data is invalid. Error details are included
401	Unauthorized