Skip to main content
POST
/
sources
/
bulk-ingest-s3-folder
/
Bulk Create Sources from S3 Folder
curl --request POST \
  --url https://api-prod.voltai.ai/source/api/sources/bulk-ingest-s3-folder/ \
  --header 'Content-Type: application/json' \
  --cookie sessionid= \
  --data '
{
  "s3_folder_url": "<string>",
  "force_reupload_existing": false,
  "parent_topic_path": [
    "<string>"
  ]
}
'
{
  "message": "<string>",
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
sessionid
string
cookie
required

Query Parameters

​
organization_name
string
required

Organization name (required for multi-tenant API keys)

Body

application/json
​
s3_folder_url
string
required

S3 folder URL (example: s3://my-bucket/docs/)

Minimum string length: 1
​
force_reupload_existing
boolean
default:false

When true, re-upload and re-parse even if source already exists.

​
parent_topic_path
string[]

Optional parent topic root-to-leaf path. This path is prefixed to each discovered file topic path.

Minimum string length: 1

Response

202 - application/json

S3 folder discovery and ingestion queued.

Response returned when an S3 folder ingestion job is queued.

​
message
string
required
​
job_id
string<uuid>
required