Claude Platform Docs

파일 목록 조회

client.Files.List(ctx, params) (*PageCursor[FileMetadata], error)
GET/v1/files

파일 목록 조회

Parameters
params FileListParams
IDs []string OptionalQuery parameter

Restrict the result set to Files whose id is in this list. At most 100 entries (after de-duplication). Mutually exclusive with page and limit. When supplied, the response is always a single page (next_page is null). IDs that do not resolve to a visible File — including deleted Files — are silently omitted.

Limit param.Opt[int64] OptionalQuery parameter

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

minimum1
maximum1000
Page param.Opt[string] OptionalQuery parameter

Opaque page cursor returned in a prior list response's next_page. Prefixed page_.

WorkspaceID param.Opt[string] OptionalHeader parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
type FileMetadata struct { Type: "file"; ID; CreatedAt; /* 5 more */ }
Type File

Object type.

For files, this is always "file".

ID string

Unique object identifier.

The format and length of IDs may change over time.

CreatedAt Time

RFC 3339 datetime string representing when the file was created.

formatdate-time
Filename string

Original filename of the uploaded file.

minLength1
maxLength500
MimeType string

MIME type of the file.

minLength1
maxLength255
SizeBytes int64

Size of the file in bytes.

minimum0
Downloadable bool Optional

Whether the file can be downloaded.

defaultfalse
ExpiresAt Time Optional

RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with expires_in_seconds, this is the upload time plus that value.

formatdate-time
파일 목록 조회
package main

import (
	"context"
	"fmt"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/option"
)

func main() {
	client := anthropic.NewClient(
		option.WithAPIKey("my-anthropic-api-key"),
	)
	page, err := client.Files.List(context.TODO(), anthropic.FileListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)
}
Returns Examples
Response 200
{
  "data": [
    {
      "id": "file_011CNha8iCJcU1wXNR6q4V8w",
      "created_at": "2025-04-15T18:37:24.100435Z",
      "filename": "document.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 102400,
      "type": "file",
      "downloadable": false,
      "expires_at": "2025-05-15T18:37:24.100435Z"
    }
  ],
  "next_page": "next_page"
}