API Reference

Knowledge Bases

Data Sources

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create Presigned URLs for Data Source File Upload

client.KnowledgeBases.DataSources.NewPresignedURLs(ctx, body) (*KnowledgeBaseDataSourceNewPresignedURLsResponse, error)

post/v2/gen-ai/knowledge_bases/data_sources/file_upload_presigned_urls

To create presigned URLs for knowledge base data source file upload, send a POST request to /v2/gen-ai/knowledge_bases/data_sources/file_upload_presigned_urls.

ParametersExpand Collapse

body KnowledgeBaseDataSourceNewPresignedURLsParams

Files param.Field[[]KnowledgeBaseDataSourceNewPresignedURLsParamsFile]optional

A list of files to generate presigned URLs for.

FileName stringoptional

Local filename

FileSize stringoptional

The size of the file in bytes.

formatint64

ReturnsExpand Collapse

type KnowledgeBaseDataSourceNewPresignedURLsResponse struct{…}

Response with pre-signed urls to upload files.

RequestID stringoptional

The ID generated for the request for Presigned URLs.

Uploads []KnowledgeBaseDataSourceNewPresignedURLsResponseUploadoptional

A list of generated presigned URLs and object keys, one per file.

ExpiresAt Timeoptional

The time the url expires at.

formatdate-time

ObjectKey stringoptional

The unique object key to store the file as.

OriginalFileName stringoptional

The original file name.

PresignedURL stringoptional

The actual presigned URL the client can use to upload the file directly.

Create Presigned URLs for Data Source File Upload

Go

HTTP

TypeScript

Python

Go

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/-go"
  "github.com/stainless-sdks/-go/option"
)

func main() {
  client := gradient.NewClient(
    option.WithAccessToken("My Access Token"),
  )
  response, err := client.KnowledgeBases.DataSources.NewPresignedURLs(context.TODO(), gradient.KnowledgeBaseDataSourceNewPresignedURLsParams{

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

200 example

{
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "uploads": [
    {
      "expires_at": "2023-01-01T00:00:00Z",
      "object_key": "example string",
      "original_file_name": "example name",
      "presigned_url": "example string"
    }
  ]
}

Returns Examples

200 example

{
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "uploads": [
    {
      "expires_at": "2023-01-01T00:00:00Z",
      "object_key": "example string",
      "original_file_name": "example name",
      "presigned_url": "example string"
    }
  ]
}