Work Management

Fibery

Learn how to use Fibery with Composio

Overview

SLUG: FIBERY

Description

Fibery is a work management platform designed to help teams collaborate, organize information, and manage their workflows.

Authentication Details

subdomain
stringRequired
generic_api_key
stringRequired

Connecting to Fibery

Create an auth config

Use the dashboard to create an auth config for the Fibery toolkit. This allows you to connect multiple Fibery accounts to Composio for agents to use.

1

Select App

Navigate to Fibery.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Fibery Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4fibery_auth_config_id = "ac_YOUR_FIBERY_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Fibery for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, fibery_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Fibery toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["FIBERY"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Delete Custom App Endpoint

Description

Tool to delete a specific custom app endpoint. Use after confirming the app and endpoint IDs to remove.

Action Parameters

app_id
stringRequired
endpoint_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Entity

Description

Tool to delete a specific Fibery entity by its ID. Use when you have verified the entity exists and have its GUID. Deletion is irreversible.

Action Parameters

entity_id
stringRequired
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete File

Description

Tool to delete a specific file. Use when you need to remove a file from Fibery by its ID.

Action Parameters

file_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Execute GraphQL Query

Description

Tool to execute GraphQL queries or mutations against a Fibery space. Use when you need to fetch or modify Fibery data via the GraphQL API.

Action Parameters

operationName
string
query
stringRequired
variables
object

Action Response

data
error
string
errors
array
message
string
successful
booleanRequired

Tool Name: Authenticate (validate token via API call)

Description

Tool to validate existing Fibery personal API token by performing a real API call. If the call succeeds, returns the token value extracted from the Authorization header. Use the returned token in the `Authorization: Token <value>` header for further calls.

Action Parameters

command_body
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get App Information

Description

Tool to retrieve application information. Use when you need the version, name, description, authentication methods, and available data sources before further operations.

Action Parameters

appId
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Custom App Endpoints

Description

Tool to list custom app endpoints. Use when you need the available custom endpoints for a given app before invoking them.

Action Parameters

app_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Custom Apps

Description

Tool to list all custom apps in the Fibery workspace. Use when you need the identifiers of all custom apps.

Action Parameters

limit
integerDefaults to 100

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Entities

Description

Tool to query Fibery entities. Use after specifying type and fields; supports optional filters and pagination.

Action Parameters

from
stringRequired
limit
integer
offset
integer
params
object
select
arrayRequired
where
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Fibery Entity

Description

Tool to retrieve detailed info of a specific Fibery entity by its ID. Uses Fibery Commands API (fibery.entity/query) filtered by fibery/id with q/limit = 1.

Action Parameters

entity_id
stringRequired
expand
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get File

Description

Tool to retrieve a file by its secret or id. Prefer the file secret to download raw bytes. Returns the file content, MIME type, and original filename if available.

Action Parameters

fileId
string
fileSecret
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get GraphQL Schema

Description

Tool to retrieve the GraphQL schema for the current workspace. Uses standard GraphQL introspection.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get User Preferences

Description

Tool to retrieve the current user's UI preferences. Use after authentication to tailor UI to user settings.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Refresh access token

Description

Tool to refresh an access token using a refresh token. Use when the current access token has expired and a valid refresh token is available.

Action Parameters

refresh_token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Authenticate with username and password

Description

Tool to authenticate with Fibery using resource owner password credentials. Use when you need an access token by providing username and password. Include the returned token in the `Authorization: Token <access_token>` header for subsequent API calls.

Action Parameters

grant_type
stringDefaults to password
password
stringRequired
username
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Entity

Description

Tool to create a new Fibery entity. Use when you have prepared all necessary field values and need to persist a new record. Example: Create a 'Project/Task' with title and assignee.

Action Parameters

entity
objectRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch Data from Source

Description

Tool to fetch data from a specified source. Use after specifying the source and optional filters.

Action Parameters

account
objectRequired
filter
object
source
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: POST_FETCH_DATA_COUNT

Description

Tool to return the count of records for a given Fibery type (source). Uses Fibery commands API and returns the total number of entities of the type.

Action Parameters

account
objectRequired
filter
objectRequired
source
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch Datalist Options

Description

Tool to fetch options for a datalist filter field. Use after retrieving field metadata to build dynamic filters.

Action Parameters

field
stringRequired
source
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch Schema

Description

Tool to fetch predefined data schema. Use after authenticating when mapping and integrating Fibery data.

Action Parameters

account
objectRequired
filter
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Exchange OAuth2 authorization code

Description

Tool to finalize OAuth2 authentication for Fibery custom apps. Use when exchanging an authorization code for access and refresh tokens after user authorization. Notes: - In Fibery custom app flows, the access_token endpoint is typically implemented by the app itself (your connector) rather than the Fibery workspace domain. We therefore probe multiple candidate roots and paths and provide resilient fallbacks.

Action Parameters

code
stringRequired
grant_type
stringDefaults to authorization_code
redirect_uri
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Revoke Access Token

Description

Tool to revoke an existing Fibery API access token. Use when invalidating a user session or logging out.

Action Parameters

token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Validate Fibery account

Description

Tool to validate account credentials. Use when confirming provided credentials (and optionally refreshing OAuth2 tokens) before further API calls.

Action Parameters

fields
objectRequired
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Validate Filter

Description

Tool to validate filter definitions. Use when ensuring filter structure and syntax are correct before running a data query.

Action Parameters

account
objectRequired
filter
objectRequired
source
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Entity

Description

Tool to update an existing Fibery entity. Uses Commands API: fibery.entity/update.

Action Parameters

entity_id
stringRequired
fields
objectRequired
type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update User Preferences

Description

Tool to update the current user's preferences by using the Commands API. It fetches the current user id and preferences, merges the provided payload, and writes back the merged object into 'fibery/ui-preferences' of the current fibery/user.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Upload File

Description

Tool to upload a file to Fibery. Use when you need to attach a local file via the Fibery Files API.

Action Parameters

file_name
string
file_path
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired