Overview

​

Purpose

​

Architecture

​

Query Parameters

​

Sampling Algorithm

1. Get all prompts for the organization
2. Separate into untested (last_tested_at IS NULL) and tested
3. Prioritize untested - take as many as possible up to sample_size
4. Fill remaining with random tested prompts

​

Response Format

{
  "status": "success",
  "org_slug": "org-slug-123",
  "total_prompts": 50,
  "untested_count": 15,
  "sample_size": 10,
  "prompts": [
    {
      "id": 123,
      "prompt": "best payment gateway for startups",
      "entity_id": "uuid-...",
      "entity_name": "Acme Corp",
      "entity_type": "business"
    }
  ]
}

​

Code Location

src/app/apis/cron/sample_prompts/routes.py

​

Used By

1. Samples prompts with this endpoint
2. Runs visibility analysis on each
3. Updates last_tested_at timestamp