> For the complete documentation index, see [llms.txt](https://teos-docs.coreledger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://teos-docs.coreledger.net/guides/assets/unlink-assets.md).

# Unlink assets

An asset, often referred to as a **token**, represents a digital artifact on the TEOS platform that can be stored, managed, and verified on the blockchain.

This endpoint unlinks one or more assets from a source asset. The transaction is created for the asset issuer’s address (the Author field in the Asset model) and must be signed by the asset issuer to complete this action.

**Preconditions:**

* Source asset with the provided uniqueAssetId exists.
* Source asset is created in the currently configured ledger.
* The user owns the source asset issuer's address.
* Target assets with the provided uniqueAssetIds exist and are currently linked.

📘 Learn more about assets -[ link](https://app.gitbook.com/o/ZaeNizhnU47lCcTSk7wB/s/8Gkk33l0DIIchfRT86LP/~/changes/1/resources/using-the-teos-api/concepts/asset)

#### Request Endpoint:

```http
POST /odata/v1.0/Assets({key})/UnlinkAssets
```

#### Parameters:

| **Parameter** | **Type** | **Description**                   | **Mandatory** |
| ------------- | -------- | --------------------------------- | ------------- |
| key           | string   | UniqueAssetId of the source asset | ✅             |

#### Request Body:

`application/json` — Encapsulates the list of target asset IDs to unlink.

| **Parameter**  | **Type** | **Description**                                                             |
| -------------- | -------- | --------------------------------------------------------------------------- |
| targetAssetIds | array    | Array of uniqueAssetIds of the assets to be unlinked from the source asset. |

#### Example Request:

```json
{
  "targetAssetIds": [
    "0xDB3A7821CE02A5E342080001",
    "0x3DE248A51D576D89EBCD0005"
  ]
}
```

#### Response Body:

`application/json` — Returns details of the unlink transaction.

#### Example Response:

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

```

#### Response Codes:

| **Code** | **Description**                                        |
| -------- | ------------------------------------------------------ |
| 202      | The unlink assets transaction was successfully placed. |
| 400      | The request is invalid. Error details are included.    |
| 401      | Unauthorized.                                          |

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://teos-docs.coreledger.net/guides/assets/unlink-assets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.