Seclai

Seclai

Sign inStart for free

Documentation

Contents

Overview

Each content source in Seclai produces content versions — individual indexed items such as articles, uploaded files, or custom documents. The Contents API lets you inspect, replace, and delete these items, as well as view the embedding chunks generated for semantic search.

Key concepts:

  • Content Version — A single indexed document tied to a source connection.
  • Embeddings — Chunked vector representations used for knowledge base retrieval. Each content version may have many embedding chunks.
  • Inline Text — Small text payloads (up to 8 KB) that can replace an existing content version without a file upload.

API Access

Content items can be managed via the Public API using your API key. All endpoints are scoped to your account.

Get Content Details

Retrieve the extracted text and metadata for a content version. Use start and end to page through large documents.

CONTENT_VERSION_ID=...

curl "https://api.seclai.com/contents/$CONTENT_VERSION_ID?start=0&end=5000" \
  -H "X-API-Key: $SECLAI_API_KEY"

Delete Content

Permanently remove a content version and its embeddings.

CONTENT_VERSION_ID=...

curl -X DELETE "https://api.seclai.com/contents/$CONTENT_VERSION_ID" \
  -H "X-API-Key: $SECLAI_API_KEY"

List Content Embeddings

View the embedding chunks for a content version. Useful for debugging chunking and indexing.

CONTENT_VERSION_ID=...

curl "https://api.seclai.com/contents/$CONTENT_VERSION_ID/embeddings?page=1&limit=20" \
  -H "X-API-Key: $SECLAI_API_KEY"

Replace Content with Inline Text

Replace the text backing an existing content version with a small inline payload (max 8 KB UTF-8).

CONTENT_VERSION_ID=...

curl -X PUT "https://api.seclai.com/contents/$CONTENT_VERSION_ID" \
  -H "X-API-Key: $SECLAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Updated article text...",
    "content_type": "text/plain",
    "title": "Updated Article",
    "metadata": {"category": "docs"}
  }'

Replace Content with File Upload

Upload a new file to replace the content for an existing content version.

CONTENT_VERSION_ID=...

curl -X POST "https://api.seclai.com/contents/$CONTENT_VERSION_ID/upload" \
  -H "X-API-Key: $SECLAI_API_KEY" \
  -F "file=@updated-doc.pdf" \
  -F "title=Updated Document" \
  -F 'metadata={"category":"reports"}'

Next Steps