Upload Document

POST

datasets

{dataset_id}

documents

Upload Document

curl --request POST \
  --url https://api.fltr.com/v1/datasets/{dataset_id}/documents \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>",
  "metadata": "<string>"
}
'

import requests

url = "https://api.fltr.com/v1/datasets/{dataset_id}/documents"

payload = {
    "content": "<string>",
    "metadata": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({content: '<string>', metadata: '<string>'})
};

fetch('https://api.fltr.com/v1/datasets/{dataset_id}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fltr.com/v1/datasets/{dataset_id}/documents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'content' => '<string>',
    'metadata' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fltr.com/v1/datasets/{dataset_id}/documents"

	payload := strings.NewReader("{\n  \"content\": \"<string>\",\n  \"metadata\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fltr.com/v1/datasets/{dataset_id}/documents")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"<string>\",\n  \"metadata\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fltr.com/v1/datasets/{dataset_id}/documents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"content\": \"<string>\",\n  \"metadata\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "document_id": "<string>",
  "dataset_id": "<string>",
  "filename": "<string>",
  "size_bytes": 123,
  "status": "<string>",
  "chunks_created": 123,
  "created_at": "<string>",
  "metadata": {}
}

Request

Uploads a document to a dataset. Supports text content, PDFs, images, and other file types.

Path Parameters

string

required

The dataset to upload to

Headers

string

required

Bearer token for authentication

Body (JSON Upload)

For text content, use JSON:

string

required

Text content to index

object

Custom metadata (title, category, tags, etc.)

Body (File Upload)

For files, use multipart/form-data:

file

required

File to upload (PDF, image, text, etc.)

string

JSON-encoded metadata object

Response

string

Unique document identifier

string

Parent dataset ID

string

Original filename (for file uploads)

integer

Document size in bytes

string

Processing status: processing, ready, failed

integer

Number of searchable chunks (available when status: ready)

string

ISO 8601 creation timestamp

object

Document metadata

Examples

Text Upload

cURL

curl -X POST https://api.fltr.com/v1/datasets/ds_abc123/documents \
  -H "Authorization: Bearer fltr_sk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "FLTR is a semantic search platform...",
    "metadata": {
      "title": "About FLTR",
      "category": "documentation",
      "tags": ["intro", "overview"]
    }
  }'

Python

response = requests.post(
    "https://api.fltr.com/v1/datasets/ds_abc123/documents",
    headers={
        "Authorization": "Bearer fltr_sk_abc123...",
        "Content-Type": "application/json"
    },
    json={
        "content": "FLTR is a semantic search platform...",
        "metadata": {
            "title": "About FLTR",
            "category": "documentation"
        }
    }
)

File Upload

cURL

curl -X POST https://api.fltr.com/v1/datasets/ds_abc123/documents \
  -H "Authorization: Bearer fltr_sk_abc123..." \
  -F "file=@document.pdf" \
  -F 'metadata={"title":"Product Guide","category":"docs"}'

Python

with open('document.pdf', 'rb') as f:
    response = requests.post(
        "https://api.fltr.com/v1/datasets/ds_abc123/documents",
        headers={"Authorization": "Bearer fltr_sk_abc123..."},
        files={"file": f},
        data={"metadata": '{"title":"Product Guide"}'}
    )

Response

{
  "document_id": "doc_xyz789",
  "dataset_id": "ds_abc123",
  "filename": "document.pdf",
  "size_bytes": 1048576,
  "status": "processing",
  "created_at": "2024-01-10T12:00:00Z",
  "metadata": {
    "title": "Product Guide",
    "category": "docs"
  }
}

Processing

Documents are processed asynchronously:

Upload - File received and stored
Extraction - Text extracted from file
Chunking - Content split into searchable segments
Embedding - Vector embeddings generated
Indexing - Added to search index

Processing typically takes 1-30 seconds depending on document size.

Supported File Types

Text: .txt, .md, .csv
Documents: .pdf, .docx, .pptx
Images: .jpg, .png (OCR applied)
Code: .py, .js, .java, etc.
Data: .json, .xml, .yaml

Limits

Max file size: 10MB
Max content length: 1M characters
Max 10,000 documents per dataset

Notes

Set title in metadata for better search results
Use category and tags for filtering
Custom metadata is searchable
Duplicate content is allowed

Upload Document

curl --request POST \
  --url https://api.fltr.com/v1/datasets/{dataset_id}/documents \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>",
  "metadata": "<string>"
}
'

import requests

url = "https://api.fltr.com/v1/datasets/{dataset_id}/documents"

payload = {
    "content": "<string>",
    "metadata": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({content: '<string>', metadata: '<string>'})
};

fetch('https://api.fltr.com/v1/datasets/{dataset_id}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fltr.com/v1/datasets/{dataset_id}/documents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'content' => '<string>',
    'metadata' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fltr.com/v1/datasets/{dataset_id}/documents"

	payload := strings.NewReader("{\n  \"content\": \"<string>\",\n  \"metadata\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fltr.com/v1/datasets/{dataset_id}/documents")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"<string>\",\n  \"metadata\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fltr.com/v1/datasets/{dataset_id}/documents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"content\": \"<string>\",\n  \"metadata\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "document_id": "<string>",
  "dataset_id": "<string>",
  "filename": "<string>",
  "size_bytes": 123,
  "status": "<string>",
  "chunks_created": 123,
  "created_at": "<string>",
  "metadata": {}
}

Overview

Datasets

Documents

MCP Endpoints

Webhooks

Request

Path Parameters

Headers

Body (JSON Upload)

Body (File Upload)

Response

Examples

Text Upload

File Upload

Response

Processing

Supported File Types

Limits

Notes

​Request

​Path Parameters

​Headers

​Body (JSON Upload)

​Body (File Upload)

​Response

​Examples

​Text Upload

​File Upload

​Response

​Processing

​Supported File Types

​Limits

​Notes

Request

Path Parameters

Headers

Body (JSON Upload)

Body (File Upload)

Response

Examples

Text Upload

File Upload

Response

Processing

Supported File Types

Limits

Notes