Agiled | Composio Docs

Overview

SLUG: AGILED

Description

Agiled is an all-in-one business management platform designed to streamline operations such as CRM, project management, finance, and more.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Agiled

Create an auth config

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

Select App

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

Configure Auth Config Settings

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

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

1 from composio import Composio
2 from composio.types import auth_scheme
3 
4 # Replace these with your actual values
5 agiled_auth_config_id = "ac_YOUR_AGILED_CONFIG_ID" # Auth config ID created above
6 user_id = "0000-0000-0000"  # UUID from database/app
7 
8 composio = Composio()
9 
10 def 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 Agiled for user {user_id}")
23     print(f"Connection status: {connection_request.status}")
24     
25     return connection_request.id
26 
27 
28 connection_id = authenticate_toolkit(user_id, agiled_auth_config_id)
29 
30 # You can verify the connection using:
31 connected_account = composio.connected_accounts.get(connection_id)
32 print(f"Connected account: {connected_account}")

Tools

Executing tools

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

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["AGILED"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def 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 
33 invoke_llm()

Tool List

AGILED_CREATE_PROJECT

Tool Name: Create Project

Description

Tool to create a new project in agiled. use when you have collected all project details and need to set up the project before assigning tasks. example: "create a new project named website redesign with start date 2023-09-01 and status in progress."

Action Parameters

deadline

string

notes

string

project_name

stringRequired

project_summary

string

start_date

stringRequired

status

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_CREATE_TASK

Tool Name: Create Task

Description

Tool to create a new task in agiled. use when you have all task details and want to add it to your project board. example: "create a task titled 'draft specs' for project 45, assigned to user 7, priority normal, due date 2025-11-05."

Action Parameters

assigned_to

integer

description

string

due_date

string

followers

array

list_id

integer

priority

string

project_id

integer

start_date

string

status

string

title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_CREATE_TICKET

Tool Name: Create Ticket

Description

Tool to create a new support ticket in agiled. use after gathering all required ticket details (subject, message, priority, user id).

Action Parameters

agent_id

integer

channel_id

integer

file

string

message

stringRequired

priority

stringRequired

subject

stringRequired

type_id

integer

user_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_GET_CONTACTS

Tool Name: Get Contacts

Description

Tool to retrieve a list of all contacts. use after configuring the api key to fetch contacts with optional pagination or search filters.

Action Parameters

page

integerDefaults to 1

per_page

integerDefaults to 30

string

Action Response

data

arrayRequired

error

string

AGILED_GET_CURRENCIES

Tool Name: Get Currencies

Description

Tool to list currencies. use when you need to fetch available currency options after authentication.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_DEALS

Tool Name: Get Deals

Description

Tool to retrieve a list of all deals. use after confirming your api key to list all deals for crm reporting.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_EMPLOYEES

Tool Name: Get Employees

Description

Tool to retrieve a list of all employees. use when you need up-to-date employee directory from agiled.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_ESTIMATES

Tool Name: Get Estimates

Description

Tool to retrieve a list of all estimates. use after configuring the api key to list estimates for reporting.

Action Parameters

page

integerDefaults to 1

per_page

integerDefaults to 30

Action Response

data

arrayRequired

error

string

AGILED_GET_EXPENSES

Tool Name: Get Expenses

Description

Tool to retrieve a list of all expenses. use after authenticating with your agiled api key to fetch all expense records.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_INVOICES

Tool Name: Get Invoices

Description

Tool to retrieve a list of all invoices from agiled. use after obtaining valid api credentials.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_PRODUCTS

Tool Name: Get Products

Description

Tool to retrieve a list of all products. use when you need to display all available offerings.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_PROJECTS

Tool Name: Get Projects

Description

Tool to retrieve a list of all projects. use after obtaining the api token.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_GET_TASKS

Tool Name: GET_TASKS

Description

Tool to retrieve a list of all tasks. use when you need to fetch all tasks across your account after authentication.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_GET_TICKETS

Tool Name: Get Tickets

Description

Tool to retrieve a list of all tickets. use after obtaining api token when you need an overview of support or issue tickets.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_GET_TIMESHEETS

Tool Name: Get Timesheets

Description

Tool to retrieve timesheets for a project. use when you have a valid project id to fetch all its time logs.

Action Parameters

project_id

integerRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_GET_USERS

Tool Name: Get Users

Description

Tool to retrieve a list of users from agiled. use when you need the full user directory for selection or validation.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AGILED_CREATE_EXPENSE

Tool Name: Create Expense

Description

Tool to create a new expense in agiled. use after gathering expense details and authenticating with your api key.

Action Parameters

currency_id

integerRequired

distance_category

stringRequired

distance_cost

integer

distance_description

string

distance_unit

string

distance_unit_rate

integer

distance_value

integerRequired

how_often

string

include_distance

string

is_infinite

string

item_name

stringRequired

make_recurring

string

next_purchase_date

string

often_terms

integer

price

numberRequired

project_id

integer

purchase_date

stringRequired

purchased_from

string

remaining_cycles

integer

status

string

term_duration

string

user_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

AGILED_GET_PROJECT_CATEGORIES

Tool Name: Get Project Categories

Description

Tool to retrieve a list of all project categories. use when you need to fetch category options before creating or filtering projects after authentication.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired