> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fibery.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about the Fibery HTTP API.

If this page doesn't answer your question, please contact us in the support chat.

## How to update the avatar with a URL to an image?

Avatars is the same file collection as the files, so check the [Files](/guides/http-api/files) guide.

You can find a [nice discussion in our community ](https://community.fibery.io/t/manipulating-the-avatar-via-automation-script/3918 "https://community.fibery.io/t/manipulating-the-avatar-via-automation-script/3918")🙂

## How to update the Icon Field?

The Icon Field is exposed as `icon/icon`. Update it with `fibery.entity/update` like any other primitive Field. The value is the icon name wrapped in colons — `:smile:`, `:heart:`, `:rocket:`. Browse the available icons in the [Unicons set](https://iconscout.com/unicons).

<CodeGroup>
  ```javascript JavaScript theme={null}
  const response = await fetch('https://YOUR_ACCOUNT.fibery.io/api/commands', {
    method: 'POST',
    headers: {
      'Authorization': 'Token YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      command: 'fibery.entity/update',
      args: {
        type: 'Cricket/Player',
        entity: {
          'fibery/id': '20f9b920-9752-11e9-81b9-4363f716f666',
          'icon/icon': ':smile:'
        }
      }
    })
  });
  const data = await response.json();
  ```

  ```bash cURL theme={null}
  curl -X POST https://YOUR_ACCOUNT.fibery.io/api/commands \
    -H 'Authorization: Token YOUR_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '
    {
      "command": "fibery.entity/update",
      "args": {
        "type": "Cricket/Player",
        "entity": {
          "fibery/id": "20f9b920-9752-11e9-81b9-4363f716f666",
          "icon/icon": ":smile:"
        }
      }
    }
    '
  ```
</CodeGroup>

## How to work with the Lookup Field?

A Lookup Field is basically the same as a Formula field.

Feel free to share your use case in [the community](https://community.fibery.io/).

## How to work with Document View?

This API is still undocumented. However, to work with Document View content using ordinary or api documents, you need only the document secret.

To obtain that secret for a document view with public id "45" one may query views api as described in the [Views](/guides/http-api/views) guide.

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "query-views",
  "params": {
    "filter": {
      "publicIds": [
        "45"
      ]
    }
  }
}
```

Response

```json theme={null}
{
  "jsonrpc": "2.0",
  "result": [
    {
      "fibery/id": "43addb30-1fd0-11ee-9009-a7c752e861c6",
      "fibery/public-id": "45",
      "fibery/name": "Supa Doc",
      "fibery/icon": null,
      "fibery/description": null,
      "fibery/rank": -9006999178042705,
      "fibery/type": "document",
      "fibery/meta": {
        "documentSecret": "e27df257-0e6f-441f-8dcc-fde2591d12c3"
      },
      ...
    }
  ]
}
```

See the `"fibery/meta"` property with `"documentSecret"` in it. With this UUID you may do whatever you need with document content via standard documents API.

## How can I check who has which permissions (capabilities) for a specific database?

You can use the **`fibery.type/query-capability-sources`** API command.\
It returns all users who have access to a given database (type) and explains how each user obtained their permissions.

### Basic API Call

```json theme={null}
[{
  "command": "fibery.type/query-capability-sources",
  "args": {
    "type": "SoftDev/Task"
  }
}]
```

This returns all active users by default along with their effective capabilities for the specified database.

### **Optional: Explicitly Limit to Active Users**

```json theme={null}
[{
  "command": "fibery.type/query-capability-sources",
  "args": {
    "type": "SoftDev/Task",
    "active-users?": true
  }
}]
```

> ℹ️ Note: `active-users?` is optional — active users are returned by default.

## API Token Activity Details

You can see the "Created" and "Last Used" dates for API tokens, along with the token prefix. For older tokens, the creation date won't be available and will show as "N/A." Activity tracking (last used date) will also be shown from September 19th, 2024.

## Is it possible to create a Formula field via API?

At the moment, we don't have a public API for this specific functionality. That said, it is technically possible to observe how Fibery's UI interacts with the backend by inspecting network requests — and from there, infer the structure of the API calls.

However, please note that these internal APIs aren't officially supported and may change at any time without notice, so we can't guarantee stability or backward compatibility.

If you have a particular use case in mind, feel free to share it — we might be able to suggest a safer or more stable approach.

## Troubleshooting

#### I'm facing timeouts when querying Entities

Use paging api.