Anthropic ListFiles

Anthropic ListFiles

Certified

List Anthropic files

Lists files stored in the Anthropic Files API using the beta Files endpoint.

yaml
type: io.kestra.plugin.anthropic.ListFiles

List files

yaml
    id: anthropic_list_files
    namespace: company.team

    tasks:
      - id: list_files
        type: io.kestra.plugin.anthropic.ListFiles
        apiKey: "{{ secret('ANTHROPIC_API_KEY') }}"
        limit: 25
Installation

Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:

kestractl plugins get io.kestra.plugin:plugin-anthropic --compatible-for $KESTRA_VERSION

For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.

For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.

Properties

Anthropic API Key

After ID

Cursor for pagination; returns results after this file ID.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Base URL

Optional Anthropic-compatible endpoint. Defaults to the SDK endpoint. Requests, including the API key, are sent to this host, so set it with forced: true in plugin defaults when the API key comes from there.

Before ID

Cursor for pagination; returns results before this file ID.

Connect timeout

Connection timeout as an ISO-8601 duration. Defaults to PT1M, and zero disables it.

Limit

Maximum number of files to return (1-1000).

Default2

Maximum retries

SDK retries for transient errors, between 0 and 10. Defaults to 2, and 0 disables them.

Read timeout

Maximum time for a response as an ISO-8601 duration, both between packets and for the whole call. Defaults to the SDK timeout (PT10M), and zero disables it.

Scope ID

Filter by scope ID, such as a session ID.

Files

List of files returned by Anthropic.

Definitions
createdAtstring

Created at

RFC 3339 timestamp of file creation.

downloadableboolean

Downloadable

Whether the file can be downloaded.

fileIdstring

File ID

Unique identifier for the file.

filenamestring

Filename

Original filename of the uploaded file.

mimeTypestring

MIME type

MIME type of the file.

scopeIdstring

Scope ID

Scope identifier for the file (e.g., session ID).

sizeinteger

Size

File size in bytes.

First ID

First file ID in the result page.

Has more

Whether more results are available.

Last ID

Last file ID in the result page.