API ReferenceFiles

List files with optional app and action filters

Markdown
GET
/api/v3/files/list

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

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Query Parameters

toolkit_slug?string

Filter files by app slug. Example: "file-converter"

tool_slug?string

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

limit?number|null

Number of items per page, max allowed is 1000

cursor?string

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 Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/files/list"
{
  "items": [
    {
      "toolkit_slug": "string",
      "tool_slug": "string",
      "filename": "string",
      "mimetype": "string",
      "md5": "string"
    }
  ],
  "next_cursor": "string",
  "total_pages": 0,
  "current_page": 0,
  "total_items": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}