API Reference

curl -X POST https://api.renbase.com/api/v1/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is the notice period for contract termination?",
    "base_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}

result = requests.post(
    "https://api.renbase.com/api/v1/ask",
    headers=headers,
    json={
        "query": "What is the notice period for contract termination?",
        "base_id": "550e8400-e29b-41d4-a716-446655440000",
    }
).json()

print(result["answer"])
for cite in result["citations"]:
    print(f"  - {cite['source']}: {cite['text'][:80]} ...")

const result = await fetch("https://api.renbase.com/api/v1/ask", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "What is the notice period for contract termination?",
    base_id: "550e8400-e29b-41d4-a716-446655440000",
  }),
}).then((r) => r.json());

console.log(result.answer);
result.citations.forEach((c) =>
  console.log(`  - ${c.source}: ${c.text}`)
);

curl -X POST https://api.renbase.com/api/v1/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "base_id=550e8400-e29b-41d4-a716-446655440000" \
  -F "files=@contract_2024.pdf" \
  -F "files=@amendment_q3.docx" \
  -F 'metadata={"filters":{"department":"legal","year":"2024"}}'

import requests

with open("contract_2024.pdf", "rb") as f:
    result = requests.post(
        "https://api.renbase.com/api/v1/ingest",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        data={"base_id": "550e8400-e29b-41d4-a716-446655440000"},
        files={"files": ("contract_2024.pdf", f, "application/pdf")}
    ).json()

job_id = result["results"][0]["job_id"]
print(f"Queued: {job_id}")

const form = new FormData();
form.append("base_id", "550e8400-e29b-41d4-a716-446655440000");
form.append("files", new Blob([fileBuffer]), "contract_2024.pdf");

const result = await fetch("https://api.renbase.com/api/v1/ingest", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
}).then((r) => r.json());

const jobId = result.results[0].job_id;

curl https://api.renbase.com/api/v1/bases/BASE_ID/files \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "files": [
    {
      "id": "6ba7b810-...",
      "name": "contract_2024.pdf",
      "status": "indexed",
      "mime_type": "application/pdf",
      "size": 2048576,
      "created_at": "2026-03-18T10:00:00Z"
    }
  ]
}

curl https://api.renbase.com/api/v1/bases/BASE_ID/files/FILE_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "6ba7b810-...",
  "name": "contract_2024.pdf",
  "status": "indexed",
  "mime_type": "application/pdf",
  "size": 2048576,
  "connector_id": null
}

curl -X DELETE https://api.renbase.com/api/v1/bases/BASE_ID/files/FILE_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

{ "deleted": "6ba7b810-9dad-11d1-80b4-00c04fd430c8" }

curl https://api.renbase.com/api/v1/bases/BASE_ID/files/FILE_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "url": "https://storage.renbase.com/...",
  "expires_at": "2026-03-18T11:00:00Z"
}

# 1. Create a base
curl -X POST https://api.renbase.com/api/v1/bases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Knowledge Base"}'

# 2. Upload a file (use the id from step 1 as BASE_ID)
curl -X POST https://api.renbase.com/api/v1/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "base_id=BASE_ID" \
  -F "files=@document.pdf"

# 3. Poll until completed (use job_id from step 2)
curl https://api.renbase.com/api/v1/ingest/JOB_ID/status \
  -H "Authorization: Bearer YOUR_API_KEY"

# 4. Search
curl -X POST https://api.renbase.com/api/v1/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is the cancellation policy?", "base_id": "BASE_ID"}'

import requests, time

API_KEY = "your_api_key"
BASE_URL = "https://api.renbase.com/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# 1. Create a base
base = requests.post(
    f"{BASE_URL}/bases", headers=headers,
    json={"name": "My Knowledge Base"}
).json()

# 2. Upload a file
with open("document.pdf", "rb") as f:
    upload = requests.post(
        f"{BASE_URL}/ingest", headers=headers,
        data={"base_id": base["id"]},
        files={"files": ("document.pdf", f, "application/pdf")}
    ).json()

job_id = upload["results"][0]["job_id"]

# 3. Poll until ready
while True:
    status = requests.get(
        f"{BASE_URL}/ingest/{job_id}/status", headers=headers
    ).json()
    if status["status"] in ("completed", "failed"):
        break
    time.sleep(2)

# 4. Search
answer = requests.post(
    f"{BASE_URL}/ask", headers=headers,
    json={"query": "What is the cancellation policy?", "base_id": base["id"]}
).json()

print(answer["answer"])
for cite in answer["citations"]:
    print(f"  - {cite['source']}: {cite['text'][:80]} ...")

const API_KEY = "your_api_key";
const BASE_URL = "https://api.renbase.com/api/v1";
const headers = { Authorization: `Bearer ${API_KEY}` };

// 1. Create a base
const base = await fetch(`${BASE_URL}/bases`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ name: "My Knowledge Base" }),
}).then((r) => r.json());

// 2. Upload a file
const form = new FormData();
form.append("base_id", base.id);
form.append("files", new Blob([fileBuffer]), "document.pdf");

const upload = await fetch(`${BASE_URL}/ingest`, {
  method: "POST", headers, body: form,
}).then((r) => r.json());

const jobId = upload.results[0].job_id;

// 3. Poll until ready
let status;
do {
  await new Promise((r) => setTimeout(r, 2000));
  status = await fetch(`${BASE_URL}/ingest/${jobId}/status`, { headers }).then((r) => r.json());
} while (![ "completed", "failed" ].includes(status.status));

// 4. Search
const result = await fetch(`${BASE_URL}/ask`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ query: "What is the cancellation policy?", base_id: base.id }),
}).then((r) => r.json());

console.log(result.answer);
result.citations.forEach((c) => console.log(`  - ${c.source}: ${c.text}`));