Extend a supply

This method allows a TEOS user to extend the expiration of an existing supply. Supply represents an offer created by a user to trade a specific amount of one asset for a specific amount of another asset. By extending a supply, the user can keep it active for a longer period, allowing other users to execute trades or participate in warps using this supply.

📘 Learn more about supplies.

Request Endpoint

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

Preconditions:

• The supply must exist.

• The supply must not be expired or deleted.

Parameters

Name	Type	Description	Mandatory
key	string	The identifier of the supply to extend	✅

Example request

POST /Supplies('0x1EAEFD42D684567ABDC7000193A96C4653DE1314DB20000167242CB20000024E')/Extend

Content-Type: application/json

    "expiryTime": "2024-02-15T23:25:24.295Z"
}

Example response

{
  "Id": "C0D34D73-6FD3-40F2-A7E1-08D9412448F7",
  "State": "3",
  "BlockchainTransactionId": "0x748ac47e7226cae0e4e13373375f33ab9e4d43ef29d85d233162a7e7e913703b",
  "CorrelationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Type": "ActivateAsset",
  "OnCreated": "2025-10-08T09:43:32.429Z",
  "OnUpdated": "2025-10-08T09:43:32.429Z",
  "OnSubmitted": "2025-10-08T09:43:32.429Z",
  "OnCommitted": "2025-10-08T09:43:32.429Z",
  "OnConfirmed": "2025-10-08T09:43:32.429Z",
  "OnRevokedByBlockchain": "2025-10-08T09:43:32.429Z",
  "OnRevokedByUser": "2025-10-08T09:43:32.429Z",
  "OnRevokedByTxServer": "2025-10-08T09:43:32.429Z",
  "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 extension data is invalid. Error details are included
401	Unauthorized