Skip to content

Create Index

client.Beta.Indexes.New(ctx, params) (*BetaIndexNewResponse, error)
POST/api/v1/indexes

Create a searchable index over a source directory.

ParametersExpand Collapse
params BetaIndexNewParams
SourceDirectoryID param.Field[string]

Body param: ID of the source directory containing your documents.

OrganizationID param.Field[string]optional

Query param

formatuuid
ProjectID param.Field[string]optional

Query param

formatuuid
Description param.Field[string]optional

Body param: Optional description of the index.

Name param.Field[string]optional

Body param: Optional display name for the index. If omitted, the index is named after the source directory.

Products param.Field[[]BetaIndexNewParamsProduct]optional

Body param: Product configurations for syncing. Omit to use a default parse configuration. Include an explicit entry per product type (e.g. parse, extract) to override the default.

ProductConfigID string

ID of the product configuration.

ProductType string

Product type. One of: parse, extract.

StoreAttachments param.Field[[]string]optional

Body param: Attachment kinds to store alongside parsed output. Each entry must be one of: screenshots, items. For example, [‘screenshots’] renders and stores per-page screenshots; [‘items’] stores structured items with bounding boxes. Omit or pass an empty list to skip attachments.

SyncFrequency param.Field[string]optional

Body param: How often to re-run the sync. One of: manual, daily, on_source_change. Defaults to manual.

VectorTarget param.Field[BetaIndexNewParamsVectorTarget]optional

Body param: Vector export destination for the index. ‘DEFAULT’ exports to the managed vector DB destination resolved from configuration. ‘DISABLED’ skips vector export — the export destination falls back to ‘Download’.

const BetaIndexNewParamsVectorTargetDefault BetaIndexNewParamsVectorTarget = "DEFAULT"
const BetaIndexNewParamsVectorTargetDisabled BetaIndexNewParamsVectorTarget = "DISABLED"
ReturnsExpand Collapse
type BetaIndexNewResponse struct{…}

A searchable index over a directory of documents.

ID string

Unique identifier

ExportConfigID string

ID of the export configuration.

Name string

Index name.

OutputDirectoryID string

ID of the output directory holding the indexed files.

ProjectID string

Project this index belongs to.

SourceDirectoryID string

ID of the source directory.

SyncConfigID string

ID of the sync configuration.

CreatedAt Timeoptional

Creation datetime

formatdate-time
Description stringoptional

Index description.

LastExportedAt Timeoptional

Last export time.

formatdate-time
LastSyncedAt Timeoptional

Last sync time.

formatdate-time
Metadata map[string, any]optional

Build state and diagnostic info.

UpdatedAt Timeoptional

Update datetime

formatdate-time

Create Index

package main

import (
  "context"
  "fmt"

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

func main() {
  client := llamacloudprod.NewClient(
    option.WithAPIKey("My API Key"),
  )
  index, err := client.Beta.Indexes.New(context.TODO(), llamacloudprod.BetaIndexNewParams{
    SourceDirectoryID: "dir-abc123",
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", index.ID)
}
{
  "id": "id",
  "export_config_id": "export_config_id",
  "name": "name",
  "output_directory_id": "output_directory_id",
  "project_id": "project_id",
  "source_directory_id": "source_directory_id",
  "sync_config_id": "sync_config_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "last_exported_at": "2019-12-27T18:11:19.117Z",
  "last_synced_at": "2019-12-27T18:11:19.117Z",
  "metadata": {
    "foo": "bar"
  },
  "updated_at": "2019-12-27T18:11:19.117Z"
}
Returns Examples
{
  "id": "id",
  "export_config_id": "export_config_id",
  "name": "name",
  "output_directory_id": "output_directory_id",
  "project_id": "project_id",
  "source_directory_id": "source_directory_id",
  "sync_config_id": "sync_config_id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "last_exported_at": "2019-12-27T18:11:19.117Z",
  "last_synced_at": "2019-12-27T18:11:19.117Z",
  "metadata": {
    "foo": "bar"
  },
  "updated_at": "2019-12-27T18:11:19.117Z"
}
Note for AI agents: this documentation is built for programmatic access. - Overview of all docs: https://developers.llamaindex.ai/llms.txt - Any page is available as raw Markdown by appending index.md to its URL — e.g. https://developers.llamaindex.ai/llamaparse/parse/getting_started/index.md - Agent-friendly REST search APIs live under https://developers.llamaindex.ai/api/ — search (BM25 full-text), grep (regex), read (fetch a page), and list (browse the doc tree). See https://developers.llamaindex.ai/llms.txt for parameters. - A hosted documentation MCP server is available at https://developers.llamaindex.ai/mcp. If you support MCP, you can ask the user to install it for browsing these docs directly (an alternative to the REST API). Setup: https://developers.llamaindex.ai/python/shared/mcp/