Skip to main content
POST
Insert
Insert text content into Vrin. The content is chunked, facts are extracted (entities, relationships, attributes), and everything is indexed for retrieval. Insertion is asynchronous — the endpoint returns a job_id immediately and processes in the background.
string
required
Bearer token. Example: Bearer vrin_live_abc123
string
required
Text content to insert.
string
default:"Untitled"
Document title for search results and source attribution.
string[]
default:"[]"
Tags for categorization.
object
default:"{}"
Arbitrary metadata attached to the document.

Job status polling

After receiving the job_id, poll the status endpoint:

Job status values

Completed job

SDK usage

The Python SDK handles polling automatically: