Private LanguageDocumentation

API Reference

Integrate Private Language with your own tools and workflows via the REST API.

Private Language provides a REST API for programmatic access to your knowledge. Use it to integrate captures, queries, and exports into your own tools and workflows.

Authentication

All API requests require a Bearer token. Generate an API key from your account settings.

Authorization: Bearer pk_live_your_api_key_here

Base URL

https://api.pvtlng.dev/v1

Core endpoints

Captures

  • POST /captures — Create a new capture (text, audio URL, or image URL)
  • GET /captures — List captures for a project
  • GET /captures/:id — Get a specific capture with extraction results

Knowledge Graph

  • GET /projects/:id/graph — Get the knowledge graph for a project
  • GET /projects/:id/atoms — List knowledge atoms
  • POST /projects/:id/query — Natural language query against your knowledge

Exports

  • POST /projects/:id/export — Export project knowledge in a specified format
  • Supported formats: json, markdown, graphml, csv

Rate limits

  • Free plan: 60 requests/hour
  • Pro plan: 600 requests/hour
  • Team plan: 6,000 requests/hour

SDKs

Official SDKs are coming soon for:

  • TypeScript/JavaScript (npm)
  • Python (pip)

In the meantime, the REST API works with any HTTP client.

Need help?

If you're building an integration and need guidance, contact us. We're happy to help.