API Reference

Beta

Directories

Files

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List Directory Files

client.Beta.Directories.Files.List(ctx, directoryID, query) (*PaginatedCursor[BetaDirectoryFileListResponse], error)

GET/api/v1/beta/directories/{directory_id}/files

List all files within the specified directory with optional filtering and pagination.

ParametersExpand Collapse

directoryID string

query BetaDirectoryFileListParams

DisplayName param.Field[string]Optional

DisplayNameContains param.Field[string]Optional

Expand param.Field[[]string]Optional

Fields to expand on each directory file.

FileID param.Field[string]Optional

IncludeDeleted param.Field[bool]Optional

OrganizationID param.Field[string]Optional

PageSize param.Field[int64]Optional

PageToken param.Field[string]Optional

ProjectID param.Field[string]Optional

UniqueID param.Field[string]Optional

UpdatedAtOnOrAfter param.Field[Time]Optional

Include items updated at or after this timestamp (inclusive)

formatdate-time

UpdatedAtOnOrBefore param.Field[Time]Optional

Include items updated at or before this timestamp (inclusive)

formatdate-time

ReturnsExpand Collapse

type BetaDirectoryFileListResponse struct{…}

API response schema for a directory file.

ID string

Unique identifier for the directory file.

DirectoryID string

Directory the file belongs to.

DisplayName string

Display name for the file.

minLength1

ProjectID string

Project the directory file belongs to.

UniqueID string

Unique identifier for the file in the directory

minLength1

CreatedAt TimeOptional

Creation datetime

formatdate-time

DeletedAt TimeOptional

Soft delete marker when the file is removed upstream or by user action.

formatdate-time

DownloadURL PresignedURLOptional

Schema for a presigned URL.

ExpiresAt Time

The time at which the presigned URL expires

formatdate-time

URL string

A presigned URL for IO operations against a private file

formaturi

minLength1

FormFields map[string, string]Optional

Form fields for a presigned POST request

FileID stringOptional

File ID for the storage location.

Metadata map[string, BetaDirectoryFileListResponseMetadataUnion]Optional

Merged metadata from all sources. Higher-priority sources override lower.

One of the following:

string

int64

float64

bool

type BetaDirectoryFileListResponseMetadataMetadataListValue []string

UpdatedAt TimeOptional

Update datetime

formatdate-time

List Directory Files

Go

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/run-llama/llama-parse-go"
  "github.com/run-llama/llama-parse-go/option"
)

func main() {
  client := llamacloud.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.Beta.Directories.Files.List(
    context.TODO(),
    "directory_id",
    llamacloud.BetaDirectoryFileListParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

200 example

{
  "items": [
    {
      "id": "id",
      "directory_id": "directory_id",
      "display_name": "x",
      "project_id": "project_id",
      "unique_id": "x",
      "created_at": "2019-12-27T18:11:19.117Z",
      "deleted_at": "2019-12-27T18:11:19.117Z",
      "download_url": {
        "expires_at": "2019-12-27T18:11:19.117Z",
        "url": "https://example.com",
        "form_fields": {
          "foo": "string"
        }
      },
      "file_id": "file_id",
      "metadata": {
        "foo": "string"
      },
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "id": "id",
      "directory_id": "directory_id",
      "display_name": "x",
      "project_id": "project_id",
      "unique_id": "x",
      "created_at": "2019-12-27T18:11:19.117Z",
      "deleted_at": "2019-12-27T18:11:19.117Z",
      "download_url": {
        "expires_at": "2019-12-27T18:11:19.117Z",
        "url": "https://example.com",
        "form_fields": {
          "foo": "string"
        }
      },
      "file_id": "file_id",
      "metadata": {
        "foo": "string"
      },
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}