# 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 ](/resources/using-the-teos-api/concepts/supply.md)about supplies.

#### **Request Endpoint**

```http
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

```http
POST /Supplies('0x1EAEFD42D684567ABDC7000193A96C4653DE1314DB20000167242CB20000024E')/Extend
```

**Content-Type:**  `application/json` 

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

#### Example response

```json
{
  "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                                                     |

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://teos-docs.coreledger.net/guides/supplies/extend-a-supply.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.