Backendless

Learn how to use Backendless with Composio

Overview

SLUG: BACKENDLESS

Description

Backendless is a comprehensive backend-as-a-service (BaaS) platform providing scalable backend functionality for mobile and web applications, including user authentication, data persistence, file storage, and custom API services.

Authentication Details

generic_api_key
stringRequired

Connecting to Backendless

Create an auth config

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

1

Select App

Navigate to the Backendless toolkit page and click “Setup Integration”.

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

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Backendless 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=["BACKENDLESS"])
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: Copy File

Description

Tool to copy a file or directory within backendless file storage. use when duplicating files to a new location after verifying source and destination paths.

Action Parameters

source_path
stringRequired
target_path
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Directory

Description

Tool to create a new directory at the specified path. use when you need to organize files under a new folder structure.

Action Parameters

directory_path
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Backendless Hive

Description

Tool to create a new hive. use when you need to provision a new hive resource before performing hive operations. example: create a hive named 'grocerystore'.

Action Parameters

hive_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Backendless Timer

Description

Tool to create a new timer with schedule and code. use when scheduling recurring or one-off tasks to run server-side logic after confirming parameters.

Action Parameters

expire
integer
frequency
objectRequired
name
stringRequired
startDate
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Directory

Description

Tool to delete a directory at the specified path in backendless file storage. use when you need to remove folders after confirming the path.

Action Parameters

directory_path
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete File

Description

Tool to delete a file at the specified path in backendless file storage. use after confirming the file's relative path and filename.

Action Parameters

relative_path
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Backendless Timer

Description

Tool to delete a backendless timer by name. use when you need to remove a scheduled timer after confirming its name.

Action Parameters

timer_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Directory Listing

Description

Tool to retrieve a listing of files and directories at a given path. use when browsing or filtering file storage directories.

Action Parameters

offset
integer
pagesize
integer
path
stringRequired
pattern
string
sub
boolean
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: General Object Retrieval

Description

Tool to retrieve objects from a specified backendless table with filtering, sorting, and pagination. use after confirming the table name and query options. example: "get users where age > 30 sorted by created desc".

Action Parameters

distinct
string
excludeProps
string
groupBy
string
having
string
loadRelations
string
offset
integer
pageSize
integer
props
string
relationsDepth
integer
relationsPageSize
integer
sortBy
string
table_name
stringRequired
user-token
string
where
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get All Values

Description

Tool to retrieve all values from a map in a specified hive. use when you need to fetch the entire contents of a hive map at once.

Action Parameters

hive_name
stringRequired
map_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Counter Value

Description

Tool to retrieve the current value of a backendless counter. use when you need to inspect an atomic counter's value.

Action Parameters

counter_name
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get File Count

Description

Tool to get the count of files in a backendless directory. use when you need to determine how many items match a filter or include subdirectories.

Action Parameters

count_directories
boolean
path
stringRequired
pattern
string
sub
boolean
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Key Items

Description

Tool to retrieve values for a specified key in a list (all, single, or range). use when you need specific elements or the entire list from a hive key. supports single index retrieval, range retrieval, or full list.

Action Parameters

from_index
integer
hive_name
stringRequired
index
integer
key
stringRequired
to_index
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Backendless Timer

Description

Tool to retrieve information about a specific timer. use when you need to inspect a timer's schedule and next run details by name.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Map Put

Description

Tool to set or update key-value pairs in a hive map. use when you need to add or update multiple entries in a hive map.

Action Parameters

entries
objectRequired
hive_name
stringRequired
map_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Move File

Description

Tool to move a file or directory within backendless file storage. use when relocating resources to a new path after verifying source and destination.

Action Parameters

source_path
stringRequired
target_path
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Publish Message

Description

Tool to publish a message to a specified messaging channel. use when you need to send notifications or events to subscribers after confirming channel and payload.

Action Parameters

channel_name
stringRequired
headers
object
message
stringRequired
publishAt
integer
publisherId
string
repeatEvery
integer
repeatExpiresAt
integer
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reset Counter

Description

Tool to reset a backendless counter back to zero. use when you need to reinitialize a counter before starting a new sequence.

Action Parameters

counter_name
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set Counter Value

Description

Tool to set a backendless counter to a specific value conditionally. use when you need to ensure the counter only updates if it currently matches an expected value.

Action Parameters

counter_name
stringRequired
expected
integerRequired
updatedvalue
integerRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Backendless Timer

Description

Tool to update schedule or code of an existing timer. use when you need to modify a timer's configuration after retrieval.

Action Parameters

code
string
expire
integer
frequency
object
name
stringRequired
startDate
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Change User Password

Description

Tool to change the password for the current user. use when you need to securely update a user's password after login. example prompt: "change my password to n3wp@ssw0rd!".

Action Parameters

password
stringRequired
user_id
stringRequired
user_token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete User

Description

Tool to delete a user by user id. use when removing a user account after confirming permissions.

Action Parameters

user_id
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find User by ID

Description

Tool to retrieve user information by id. use when you need to fetch details for a specific user after you have their objectid.

Action Parameters

user_id
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Grant Permission to User

Description

Tool to grant a permission to a user on a specific data object. use when precise access rights must be assigned after verifying the table and object ids. example: "grant find permission to a user for a person record".

Action Parameters

object_id
stringRequired
permission
stringRequired
table_name
stringRequired
user
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: User Login

Description

Tool to log in a registered user with identity and password. use when you need to authenticate a user before making subsequent requests. example: "login alice@wonderland.com with password wonderland".

Action Parameters

login
stringRequired
password
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: User Logout

Description

Tool to log out the currently authenticated user. use when you need to terminate the user session after operations.

Action Parameters

user-token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: User Password Recovery

Description

Tool to initiate password recovery for a user. use when a user requests a password reset after forgetting their password. triggers an email with recovery instructions.

Action Parameters

user_identity
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: User Registration

Description

Tool to register a new user with email and password. use when creating a user account or converting a guest account to a registered one after collecting credentials. example: register 'alice@wonderland.com' with password 'wonderland'.

Action Parameters

email
stringRequired
objectId
string
password
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Revoke Permission from User

Description

Tool to revoke a permission from a specified user or role on a data table. use when you need to deny a previously granted data-table operation for a user or role in cloudcode after confirming the target.

Action Parameters

permission
stringRequired
role
string
table_name
stringRequired
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update User

Description

Tool to update properties of an existing backendless user. use when you need to modify user profile fields after login. example: update phonenumber to "5551212".

Action Parameters

properties
objectRequired
user_id
stringRequired
user_token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Validate User Token

Description

Tool to validate a user session token. use after obtaining a token from login to confirm the session is active.

Action Parameters

userToken
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired