Subscribe to a global source

Subscribe to an existing globally indexed public source for instant access.

This endpoint checks if a public source (repository, documentation, research paper, or HuggingFace dataset) is already indexed globally. If it is, it creates a local reference for the user so they can search it immediately without re-indexing.

Supported source types:

• repository: GitHub repositories (https://github.com/owner/repo)
• documentation: Documentation websites (https://docs.example.com)
• research_paper: arXiv papers (https://arxiv.org/abs/2312.00752 or 2312.00752)
• huggingface_dataset: HuggingFace datasets (https://huggingface.co/datasets/squad or squad)

Behavior by source type:

• For repositories, documentation, and research papers: Returns instant_access if indexed, wait_for_indexing if currently being indexed, or not_indexed if not found.
• For HuggingFace datasets: If not already indexed, automatically triggers indexing and returns indexing_started.

Use this when you want to access a public source that may already be indexed by others. If the source is not yet indexed, use the appropriate index endpoint instead (e.g., POST /repositories, POST /data-sources, POST /research-papers, POST /huggingface-datasets).