Welcome to the Cortex SDK API Reference. This section documents every available endpoint and how to interact with them to power AI apps and agents with intelligent memory and retrieval.
Base URL: https://api.usecortex.ai Contact us to get your API key at founders@usecortex.ai 
Authorization: Bearer <your_api_key>

​
Upload APIs

Send knowledge into Cortex. Upload documents, batch files, and scrape webpages.
  • /upload/upload_document
  • /upload/batch_upload
  • /upload/scrape_webpage

​
Search API

Ask questions. Retrieve personalized answers from memory and indexed sources.
  • /search/qna — supports an optional metadata parameter to filter sources by source_title or source_type.

​
Listing APIs

Browse what’s in your Cortex memory or knowledge store.
  • /list/sources
  • /list/sources_by_id
  • /fetch/fetch_content

​
Knowledge Management

Manage knowledge entries, delete outdated or unwanted context.
  • /delete_memory

​
Processing Verification

Check if a file or page was successfully processed.
  • /upload/verify_processing

​
User Memory APIs

Personalize, retrieve, and manage user-specific AI memories for advanced agentic workflows:
  • /user_memory/list_user_memories
  • /user_memory/retrieve_user_memory
  • /user_memory/add_user_memory
  • /user_memory/generate_user_memory
  • /user_memory/delete_user_memory

​
💡 Best Practices

  • Use sub-tenants to support multi-user isolation in B2B use cases.
  • Leverage metadata (e.g., source_title, source_type in the QnA API) for fine-grained filtering and agentic retrieval.
  • Tune search_alpha and recency_bias to control relevance.
  • Enable highlight_chunks for chunk-level citations.