List files

client.Files.List(ctx, query) (*FileList, error)

GET/files

List the files in your namespace, newest first. Keyset-paginated: when has_more is true, pass next_cursor back as cursor.

ParametersExpandCollapse

query FileListParams

Cursor param.Field[string]

optional

Opaque pagination cursor from a prior response's next_cursor.

Limit param.Field[int64]

optional

Maximum files to return (1–100). Defaults to 25.

minimum: 1, maximum: 100

Purpose param.Field[FilePurpose]

optional

Filter to files with this purpose.

State param.Field[FileState]

optional

Filter to files in this state.

ReturnsExpandCollapse

type FileList struct{…}

Keyset-paginated page of files, newest first. When has_more is true, pass next_cursor back as the cursor query parameter to fetch the next page. next_cursor is opaque.

Data []File

Files in this page.

ID string

File identifier, referenced as ImageRef.file_id.

format: uuid

CreatedAt Time

Creation timestamp.

format: date-time

MimeType string

MIME type of the stored bytes (for example, image/jpeg).

Purpose FilePurpose

How the file is intended to be used in a generation. input is the primary subject (e.g. the source image for an edit); reference is style/content guidance.

One of the following:

const FilePurposeInput FilePurpose = "input"

const FilePurposeReference FilePurpose = "reference"

SizeBytes int64

Size of the stored object in bytes.

State FileState

Lifecycle state of an uploaded file. pending until bytes are received and the ingest pipeline runs; ready once it can be referenced from a generation; failed if ingest/moderation rejected it; deleted once the file has been deleted.

One of the following:

const FileStatePending FileState = "pending"

const FileStateReady FileState = "ready"

const FileStateFailed FileState = "failed"

const FileStateDeleted FileState = "deleted"

DeletedAt Time

optional

When the file was deleted; null otherwise.

format: date-time

ExpiresAt Time

optional

TTL set at upload, if any. After this time Luma may automatically delete the file and reclaim its bytes — you don't need to call DELETE yourself.

format: date-time

FailureReason string

optional

Human-readable reason when state is failed.

Filename string

optional

Original filename supplied at upload, if any.

UserID string

optional

The opaque end-user tag supplied at upload, echoed back unchanged. Abuse-attribution only; not an access-control primitive.

HasMore bool

Whether more files exist beyond this page.

NextCursor string

optional

Opaque cursor for the next page, when has_more is true.

List files

HTTPTypeScriptPythonGoCLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/lumalabs/luma-agents-go"
  "github.com/lumalabs/luma-agents-go/option"
)

func main() {
  client := lumaagents.NewClient(
    option.WithAuthToken("My Auth Token"),
  )
  fileList, err := client.Files.List(context.TODO(), lumaagents.FileListParams{

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

200 example

{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "created_at": "2019-12-27T18:11:19.117Z",
      "mime_type": "mime_type",
      "purpose": "input",
      "size_bytes": 0,
      "state": "pending",
      "deleted_at": "2019-12-27T18:11:19.117Z",
      "expires_at": "2019-12-27T18:11:19.117Z",
      "failure_reason": "failure_reason",
      "filename": "filename",
      "user_id": "user_id"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}

Returns Examples

200 example

{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "created_at": "2019-12-27T18:11:19.117Z",
      "mime_type": "mime_type",
      "purpose": "input",
      "size_bytes": 0,
      "state": "pending",
      "deleted_at": "2019-12-27T18:11:19.117Z",
      "expires_at": "2019-12-27T18:11:19.117Z",
      "failure_reason": "failure_reason",
      "filename": "filename",
      "user_id": "user_id"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}