system-prompts-and-models-of-ai-tools/dealix/docs/architecture/API_MAP.md

Dealix API Map

Auto-generated from api/routers/*.py. Total: 145 endpoints.

Method	Path	Router	Function	Description
GET	/api/v1/admin/approvals/pending	admin	approvals_pending
POST	/api/v1/admin/approvals/request	admin	approvals_request
GET	/api/v1/admin/approvals/stats	admin	approvals_stats
GET	/api/v1/admin/approvals/{request_id}	admin	approvals_get
POST	/api/v1/admin/approvals/{request_id}/decide	admin	approvals_decide	Trigger a Sentry test error — verify DSN is live.
GET	/api/v1/admin/cache/stats	admin	cache_stats	Semantic cache hit/miss stats.
GET	/api/v1/admin/costs	admin	costs	Aggregate LLM spend over the last N hours.
GET	/api/v1/admin/dlq/stats	admin	dlq_stats	Dead-letter queue depth and last errors across all queues.
POST	/api/v1/admin/dlq/{queue}/drain	admin	dlq_drain	Remove up to limit items from a DLQ. Caller is responsible for replay.
GET	/api/v1/admin/dlq/{queue}/peek	admin	dlq_peek	Inspect the first N items in a DLQ without removing them.
GET	/api/v1/admin/sentry-check	admin	sentry_check	Trigger a Sentry test error — verify DSN is live.
POST	/api/v1/agents/icp-match	agents	run_icp_match
POST	/api/v1/agents/intake	agents	run_intake
POST	/api/v1/agents/pain-extractor	agents	run_pain_extractor
POST	/api/v1/agents/research	agents	run_research
POST	/api/v1/automation/daily-targeting/run	automation	run_daily_targeting
POST	/api/v1/automation/followups/run	automation	run_followups
POST	/api/v1/automation/reply/classify	automation	classify_reply_endpoint	Health summary — counts of today's sends, replies, suppressions.
GET	/api/v1/automation/status	automation	automation_status	Health summary — counts of today's sends, replies, suppressions.
POST	/api/v1/compliance/check-outreach	automation	compliance_check
GET	/api/v1/admin/db-diag	autonomous	db_diag	Show DATABASE_URL prefix (redacted) + try a simple query.
POST	/api/v1/admin/init-db	autonomous	admin_init_db	Force-create all tables. Idempotent. Public for debug — secure in prod.
POST	/api/v1/admin/test-insert	autonomous	admin_test_insert	Insert one test row and report exact error if it fails.
POST	/api/v1/channels/policy	autonomous	channel_policy
POST	/api/v1/companies/intake	autonomous	company_intake
POST	/api/v1/conversations	autonomous	create_conversation
GET	/api/v1/conversations	autonomous	list_conversations
POST	/api/v1/customers/onboard	autonomous	customer_onboard	Mark customer onboarding milestone.
GET	/api/v1/dashboard/metrics	autonomous	dashboard_metrics
POST	/api/v1/deals	autonomous	create_deal
GET	/api/v1/deals	autonomous	list_deals
PATCH	/api/v1/deals/{deal_id}	autonomous	update_deal
POST	/api/v1/integrations/google-lead-form	autonomous	alias_google_lead
POST	/api/v1/integrations/meta-lead-form	autonomous	alias_meta_lead
POST	/api/v1/leads/import/google-ads	autonomous	import_google_lead
POST	/api/v1/leads/import/meta	autonomous	import_meta_lead
POST	/api/v1/outreach/queue	autonomous	queue_outreach	Add an outreach item to queue (one-by-one human-final-send model for restricted channels).
GET	/api/v1/outreach/queue	autonomous	list_queue
PATCH	/api/v1/outreach/queue/{queue_id}	autonomous	update_queue_item
POST	/api/v1/partners/intake	autonomous	partner_intake	Add a partner (agency / implementation / referral / strategic).
POST	/api/v1/payments/manual-request	autonomous	manual_payment_request	Mark deal as payment_requested + create matching task.
POST	/api/v1/payments/mark-paid	autonomous	mark_paid	Mark deal as paid + auto-create customer onboarding.
POST	/api/v1/tasks	autonomous	create_task
GET	/api/v1/tasks	autonomous	list_tasks
PATCH	/api/v1/tasks/{task_id}	autonomous	update_task
GET	/api/v1/data/accounts	data	list_accounts
GET	/api/v1/data/accounts/{account_id}	data	get_account
POST	/api/v1/data/accounts/{account_id}/score	data	score_account	Recompute score from current data in the graph.
POST	/api/v1/data/import	data	create_import
POST	/api/v1/data/import/{import_id}/dedupe	data	dedupe_import	Match accounts created by this import against the existing graph.
POST	/api/v1/data/import/{import_id}/enrich	data	enrich_import
POST	/api/v1/data/import/{import_id}/normalize	data	normalize_import
GET	/api/v1/data/import/{import_id}/report	data	import_report
GET	/api/v1/data/imports	data	list_imports
GET	/api/v1/data/sources/catalog	data	list_data_sources	Compliance-graded Saudi business data source catalog.
POST	/api/v1/data/suppression	data	add_suppression
GET	/api/v1/data/suppression	data	list_suppression
POST	/api/v1/accounts/{account_id}/brief	dominance	account_brief
POST	/api/v1/automation/score-tuner/run	dominance	score_tuner_run
POST	/api/v1/customers/{customer_id}/proof-pack	dominance	customer_proof_pack
GET	/api/v1/dashboard/dominance	dominance	dashboard_dominance
GET	/api/v1/objections/bank	dominance	objections_bank	Return all 13 objection categories with response drafts.
POST	/api/v1/offers/route	dominance	offers_route
POST	/api/v1/partners/revenue-machine/run	dominance	partners_revenue_machine_run
GET	/api/v1/signals/account/{account_id}	dominance	get_signals_for_account	Return persisted SignalRecord rows + freshly-detected signals.
POST	/api/v1/automation/daily-report/generate	drafts	automation_daily_report_generate
GET	/api/v1/automation/revenue-machine/export	drafts	revenue_machine_export
POST	/api/v1/automation/revenue-machine/run	drafts	revenue_machine_run
GET	/api/v1/dashboard/revenue-machine/history	drafts	dashboard_revenue_machine_history	Last N days of revenue machine output (default 14).
GET	/api/v1/dashboard/revenue-machine/today	drafts	dashboard_revenue_machine_today
POST	/api/v1/gmail/drafts/create	drafts	gmail_drafts_create	Create a single Gmail draft. Body: to_email, subject, body_plain, account_id.
POST	/api/v1/gmail/drafts/create-batch	drafts	gmail_drafts_create_batch
GET	/api/v1/gmail/drafts/today	drafts	gmail_drafts_today
POST	/api/v1/linkedin/drafts/create	drafts	linkedin_drafts_create	Create a LinkedIn draft. NEVER auto-sent. Body: company_name, message_ar, optional rest.
GET	/api/v1/linkedin/drafts/today	drafts	linkedin_drafts_today
POST	/api/v1/linkedin/drafts/{draft_id}/manual-capture	drafts	linkedin_drafts_manual_capture
PATCH	/api/v1/linkedin/drafts/{draft_id}/mark-sent	drafts	linkedin_drafts_mark_sent	Sami marks 'I sent this manually'. Updates status + sent_at.
POST	/api/v1/replies/respond	drafts	replies_respond
POST	/api/v1/replies/route	drafts	replies_route
POST	/api/v1/email/connect/gmail	email_send	connect_gmail	Returns the exact 8-step OAuth setup Sami runs once locally.
POST	/api/v1/email/replies/sync	email_send	replies_sync
POST	/api/v1/email/send-approved	email_send	send_approved
POST	/api/v1/email/send-batch	email_send	send_batch
GET	/api/v1/email/status	email_send	email_status
POST	/api/v1/os/bulk-process	full_os	os_bulk_process
POST	/api/v1/os/process	full_os	os_process
POST	/api/v1/os/process-and-act	full_os	os_process_and_act
GET	/api/v1/os/stages	full_os	list_stages	Show all 12 stages + allowed transitions.
POST	/api/v1/os/test-send	full_os	os_test_send
GET	/api/v1/os/whatsapp-providers	full_os	whatsapp_providers_status	Which WhatsApp providers are configured + the smart-fallback chain order.
GET	/_test_sentry	health	test_sentry	Deliberate error to verify Sentry integration.
GET	/health	health	health	Liveness + config summary.
GET	/health/deep	health	health_deep	Deep health check — verifies DB, Redis, LLM providers.
GET	/healthz	health	healthz	Standard healthz alias for UptimeRobot/K8s probes.
GET	/live	health	live	Liveness probe.
GET	/ready	health	ready	Readiness probe.
POST	/api/v1/leads	leads	create_lead	Submit a new lead — runs through the full acquisition pipeline.
POST	/api/v1/leads/discover/local	leads	discover_local_endpoint	Saudi local lead engine — chains Google Places → SerpApi → Apify → static.
GET	/api/v1/leads/discover/local-industries	leads	list_local_industries	Saudi local lead engine — chains Google Places → SerpApi → Apify → static.
POST	/api/v1/leads/discover/web	leads	discover_web_endpoint	Web lead discovery via SearchProvider chain (Google CSE → Tavily → static).
POST	/api/v1/leads/enrich/batch	leads	enrich_batch_endpoint
POST	/api/v1/leads/enrich/full	leads	enrich_full_endpoint
POST	/api/v1/outreach/prepare-from-data	outreach	prepare_from_data
GET	/api/v1/outreach/queue	outreach	list_queue
POST	/api/v1/outreach/queue/{queue_id}/approve	outreach	approve_queue
POST	/api/v1/outreach/queue/{queue_id}/skip	outreach	skip_queue
POST	/api/v1/checkout	pricing	create_checkout
GET	/api/v1/pricing/plans	pricing	list_plans	List available plans. Not linked from landing — required for approval-gated quotes.
POST	/api/v1/webhooks/moyasar	pricing	moyasar_webhook
POST	/api/v1/prospect/bulk-enrich	prospect	bulk_enrich
POST	/api/v1/prospect/contacts	prospect	contacts
POST	/api/v1/prospect/demo	prospect	demo	Canned demo response for landing UI preview. No LLM call.
POST	/api/v1/prospect/discover	prospect	discover
POST	/api/v1/prospect/enrich-domain	prospect	enrich_domain
POST	/api/v1/prospect/enrich-tech	prospect	enrich_tech
POST	/api/v1/prospect/inbound/email	prospect	inbound_email
POST	/api/v1/prospect/inbound/form	prospect	inbound_form
POST	/api/v1/prospect/inbound/handle	prospect	inbound_handle
POST	/api/v1/prospect/inbound/linkedin	prospect	inbound_linkedin
POST	/api/v1/prospect/inbound/sms	prospect	inbound_sms
POST	/api/v1/prospect/inbound/whatsapp	prospect	inbound_whatsapp
POST	/api/v1/prospect/message	prospect	message_endpoint
POST	/api/v1/prospect/route	prospect	route_endpoint
POST	/api/v1/prospect/score	prospect	score_endpoint
POST	/api/v1/prospect/search	prospect	search
GET	/api/v1/prospect/search-diag	prospect	search_diag	Diagnose env var presence without revealing values.
GET	/api/v1/prospect/use-cases	prospect	list_use_cases
POST	/api/v1/public/demo-request	public	demo_request	Public landing form — captures demo request and returns Calendly booking URL.
GET	/api/v1/public/health	public	public_health	Unauthenticated health probe for landing page to show live status.
POST	/api/v1/public/partner-application	public	partner_application	Public partner signup — for agencies/freelancers/consultants.
POST	/api/v1/customers/daily-report	revenue	customers_daily_report
POST	/api/v1/leads/score	revenue	score_lead_body
POST	/api/v1/negotiation/respond	revenue	negotiation_respond
POST	/api/v1/partners/deal	revenue	partners_deal
POST	/api/v1/partners/outreach	revenue	partners_outreach
POST	/api/v1/sales/proposal	sales	generate_proposal	Generate a proposal on demand (outside the pipeline).
POST	/api/v1/sales/script	sales	build_script	Return a bilingual sales script for a given sector + type.
GET	/api/v1/sectors/best/opportunity	sectors	best_opportunity	Return the highest-leverage sector.
POST	/api/v1/sectors/content	sectors	generate_content	Generate a content piece for a sector topic.
GET	/api/v1/sectors/target/list	sectors	target_sectors	Our top-5 target sectors.
GET	/api/v1/sectors/{sector}	sectors	sector_intel	Deep intel for one Saudi sector.
POST	/api/v1/webhooks/calendly	webhooks	calendly_webhook	Receive Calendly event lifecycle notifications.
POST	/api/v1/webhooks/hubspot	webhooks	hubspot_webhook	Receive HubSpot subscription events.
GET	/api/v1/webhooks/whatsapp	webhooks	whatsapp_verify	Meta WhatsApp webhook verification.
POST	/api/v1/webhooks/whatsapp	webhooks	whatsapp_incoming	Handle incoming WhatsApp messages — route them as leads.

By router

• admin: 11 endpoints
• agents: 4 endpoints
• automation: 5 endpoints
• autonomous: 25 endpoints
• data: 12 endpoints
• dominance: 8 endpoints
• drafts: 14 endpoints
• email_send: 5 endpoints
• full_os: 6 endpoints
• health: 6 endpoints
• leads: 6 endpoints
• outreach: 4 endpoints
• pricing: 3 endpoints
• prospect: 18 endpoints
• public: 3 endpoints
• revenue: 5 endpoints
• sales: 2 endpoints
• sectors: 4 endpoints
• webhooks: 4 endpoints