Skip to main content
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 guide. You can find a nice discussion in our community 🙂

​
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. 
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();

​
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.

​
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 guide. 
{
  "jsonrpc": "2.0",
  "method": "query-views",
  "params": {
    "filter": {
      "publicIds": [
        "45"
      ]
    }
  }
}
Response 
{
  "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

[{
  "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

[{
  "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.