Get resolved requester context

This page documents the canonical HTTP contract for this endpoint.

This route requires an authenticated user session. Developer API keys are blocked by the shared auth dependency with HTTP 403.

This endpoint is the live readiness counterpart to GET /api/capabilities.

Use it when you need caller-specific requester context for AI drafting or workflow preflight.

variables returns the effective org + personal requester context that the enrichment/runtime layer will actually see.
draft_readiness.requester_context reports primary and secondary fields, available fields, and missing primary/secondary fields. research_context reports supported sources and the starred-field default; it does not evaluate a caller's selected research fields.

Errors

Status	Meaning
401	Missing or invalid user session.
403	Developer API keys are blocked for this session-only route.
404	Requester context service reports a missing context value.
500	Unexpected context-resolution error, including missing user context caught by the handler.

Example

bash

curl -X GET "https://app.autotouch.ai/api/llm/company-context" \
  -H "Authorization: Bearer <user_session_token>"

Response example

json

{
  "variables": {
    "user_company_name": "Acme",
    "user_value_proposition": "",
    "buyer_persona": "",
    "user_persona": "Founder-led teams",
    "user_ideal_titles": "Head of Growth, VP Marketing"
  },
  "draft_readiness": {
    "overall": "degraded",
    "requester_context": {
        "status": "degraded",
        "primary_fields": ["user_value_proposition", "buyer_persona"],
        "secondary_fields": ["user_persona", "user_ideal_titles"],
        "available_fields": ["user_persona", "user_ideal_titles"],
        "missing_primary_fields": ["user_value_proposition", "buyer_persona"],
        "missing_secondary_fields": [],
        "recommended": true
      },
      "research_context": {
        "status": "supported_not_evaluated",
        "supported_sources": ["explicit_field_ids", "starred_fallback"],
        "default_source": "starred_fallback",
        "recommended": true,
        "recommendation": "Prefer curated research context when row-specific nuance materially improves drafts. If explicit field IDs are not provided, starred fields are used by default."
      },
      "recommendation": "Use requester context plus curated research context for higher-quality drafts. Requester context is loaded automatically; row-specific context should be curated when it matters.",
      "suggested_next_steps": [
        "autotouch onboarding submit-domain --website <YOUR_COMPANY_WEBSITE>",
        "autotouch org-context set --value-proposition \"...\" --buyer-persona \"...\""
    ]
  },
  "requester_context_sources": {}
}