> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attio: List Files

> List the files and folders stored on an Attio record. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the files and folders stored on an Attio record.

> [!NOTE]
>
> Tool ID: `attio_list_files`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attio_list_files',
  {
    "object": "example",
    "record_id": "record_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attio_list_files --input '{
  "object": "example",
  "record_id": "record_123"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe attio_list_files --json` for the complete live contract.

## Input reference

List files and folders for a record.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.object` | `string` | Yes | — | Object slug or ID. Minimum length: 1. |
| `payload.record_id` | `string` | Yes | — | Record ID. Minimum length: 1. |
| `payload.storage_provider` | `"attio" \| "dropbox" \| "box" \| "google-drive" \| "microsoft-onedrive"` | No | — | Optional storage-provider filter. Allowed: `attio`, `dropbox`, `box`, `google-drive`, `microsoft-onedrive`. |
| `payload.parent_folder_id` | `string` | No | — | Optional parent folder ID. Minimum length: 1. |
| `payload.limit` | `integer` | No | — | Maximum number of items to return. |
| `payload.cursor` | `string` | No | — | Opaque Attio cursor used to fetch the next page. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "List files and folders for a record.",
    "properties": {
      "object": {
        "type": "string",
        "description": "Object slug or ID.",
        "minLength": 1
      },
      "record_id": {
        "type": "string",
        "description": "Record ID.",
        "minLength": 1
      },
      "storage_provider": {
        "type": "string",
        "description": "Optional storage-provider filter.",
        "enum": [
          "attio",
          "dropbox",
          "box",
          "google-drive",
          "microsoft-onedrive"
        ]
      },
      "parent_folder_id": {
        "type": "string",
        "description": "Optional parent folder ID.",
        "minLength": 1
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of items to return."
      },
      "cursor": {
        "type": "string",
        "description": "Opaque Attio cursor used to fetch the next page."
      }
    },
    "required": [
      "object",
      "record_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `record` | Yes | — | Provider response payload. |
| `result.meta` | `record` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "additionalProperties": {}
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Attio provider guide](https://deepline.com/docs/providers/attio/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.