List files with optional app and action filters

Retrieves a list of files associated with the authenticated project. Results can be filtered by toolkit and tool slugs.

Query parameters

toolkit_slugstringOptional

Filter files by app slug. Example: “file-converter”

tool_slugstringOptional

Filter files by action slug. Example: “convert-to-pdf”

limitintegerOptional

Number of items per page

cursorstringOptional

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

Response

Successfully retrieved files

itemslist of objects

total_pagesinteger

current_pageinteger

total_itemsinteger

next_cursorstring or null

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/files/list"
4
5	querystring = {"toolkit_slug":"foo","tool_slug":"foo","limit":"42","cursor":"foo"}
6
7	headers = {"x-api-key": "<x-api-key>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"items": [
3	{
4	"toolkit_slug": "foo",
5	"tool_slug": "foo",
6	"filename": "foo",
7	"mimetype": "foo",
8	"md5": "foo"
9	}
10	],
11	"total_pages": 42,
12	"current_page": 42,
13	"total_items": 42,
14	"next_cursor": "foo"
15	}

Headers

Query parameters

Response