# How to embed links in rich text field via API?

**URL:** <https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161>\
**Category:** API & Programming\
**Created:** [September 16, 2023, 10:01am UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161 "2023-09-16T10:01:59Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Ooker](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/ooker/32/7033_2.png) [@Ooker](https://community.fibery.io/u/Ooker)\
**Post date:** [September 16, 2023, 10:01am UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161/1 "2023-09-16T10:01:59Z")

</div>

The first step is to workout how to [Update rich text Field](https://api.fibery.io/?javascript#update-rich-text-field "- Update rich text Field – Fibery API") documentation. This is my code:

```js
import Fibery from 'npm:fibery-unofficial';
const fibery = new Fibery({host: "ooker.fibery.io", token: 'XXX});
const spaceName = 'a';
const databaseName = 'Literature';

async function getCollabDoc(id) {
  const players = await fibery.entity.query({
      'q/from': `${spaceName}/${databaseName}`,
    'q/select': [
      'fibery/id',
      { 'a/Description': ['Collaboration~Documents/secret'] }
    ],
    'q/where': ['=', ['fibery/id'], '$id'],
    'q/limit': 1
  }, { '$id': id });

  console.log(players);
}
const idList = [
    '46cf6d13-9268-4b1f-bb46-d533c95085b2', // Collaboration~Documents/secret
    '47748e94-1937-4b01-82de-3aa318b856ac', // Collaboration~Documents/Document
    '58468b5f-83b2-45fe-8c75-9954237f5bad', // a/Literature
    '3397b307-1b2d-4eb5-a252-340317b1d1b3', // a/Description
]

const content = 'Virat Kohli (born 5 November 1988) is an Indian [cricketer](https://en.wikipedia.org/wiki/Cricket) who currently captains the India national team.\\nHe plays for Royal Challengers Bangalore in the Indian Premier League.';
for (const id of idList) {
    console.log(id)
    await getCollabDoc(id);     
    await fibery.document.update(id, content, 'md');
}

```

I try to exhaust all IDs I can think of, but all of them return empty arrays. Do you have any idea?

Here is the schema for `a/Description`:

```auto
{
  "fibery/name": "a/Description",
  "fibery/type": "Collaboration~Documents/Document",
  "fibery/deleted?": false,
  "fibery/meta": {
    "fibery/readonly?": false,
    "ui/hidden?": false,
    "fibery/entity-component?": true,
    "fibery/required?": true,
    "ui/type-editor-order": 2
  },
  "fibery/id": "3397b307-1b2d-4eb5-a252-340317b1d1b3"
},

```

I see that its type is `Collaboration~Documents/Document`, not `Collaboration~Documents/secret`. Is this normal?

---

<div class="post-metadata">

**Author:** ![Chr1sG](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/chr1sg/32/3941_2.png) [@Chr1sG](https://community.fibery.io/u/Chr1sG)\
**Post date:** [September 16, 2023, 11:10am UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161/2 "2023-09-16T11:10:04Z")

</div>

What do you see in the console log?

---

<div class="post-metadata">

**Author:** ![Ooker](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/ooker/32/7033_2.png) [@Ooker](https://community.fibery.io/u/Ooker)\
**Post date:** [September 16, 2023, 11:56am UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161/3 "2023-09-16T11:56:54Z")

</div>

```auto
46cf6d13-9268-4b1f-bb46-d533c95085b2
test.js:39
(0) []
test.js:26
47748e94-1937-4b01-82de-3aa318b856ac
test.js:39
(0) []
test.js:26
58468b5f-83b2-45fe-8c75-9954237f5bad
test.js:39
(0) []
test.js:26
3397b307-1b2d-4eb5-a252-340317b1d1b3
test.js:39
(0) []

```

---

<div class="post-metadata">

**Author:** ![Chr1sG](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/chr1sg/32/3941_2.png) [@Chr1sG](https://community.fibery.io/u/Chr1sG)\
**Post date:** [September 16, 2023, 12:00pm UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161/4 "2023-09-16T12:00:09Z")

</div>

> [@Ooker](#):
>
> ```auto
> '46cf6d13-9268-4b1f-bb46-d533c95085b2', // Collaboration~Documents/secret
> '47748e94-1937-4b01-82de-3aa318b856ac', // Collaboration~Documents/Document
> '58468b5f-83b2-45fe-8c75-9954237f5bad', // a/Literature
> '3397b307-1b2d-4eb5-a252-340317b1d1b3', // a/Description
> 
> ```

Where did these IDs come from?

---

<div class="post-metadata">

**Author:** ![Ooker](https://sea2.discourse-cdn.com/flex020/user_avatar/community.fibery.io/ooker/32/7033_2.png) [@Ooker](https://community.fibery.io/u/Ooker)\
**Post date:** [September 16, 2023, 12:36pm UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161/5 "2023-09-16T12:36:36Z")

</div>

I simply get the schema and manually find the IDs:

```js
const schema = await fibery.getSchema();
console.log(schema)

```

---

<div class="post-metadata">

**Author:** ![dbolz](https://avatars.discourse-cdn.com/v4/letter/d/cc9497/32.png) [@dbolz](https://community.fibery.io/u/dbolz)\
**Post date:** [September 22, 2025, 12:09pm UTC](https://community.fibery.io/t/how-to-embed-links-in-rich-text-field-via-api/5161/6 "2025-09-22T12:09:01Z")

</div>

Did you ever figure this out?