Enqueue a research query plan

curl -X POST https://api.loreos.app/v1/characters/slug/research/query-plans/enqueue \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "planner_input": {
    "current_date": "2024-06-01",
    "character_id": "char_987654321",
    "character_name": "Evelyn the Archivist",
    "character_profile": "Evelyn is a meticulous historian specializing in ancient civilizations and their lost technologies.",
    "provider_allowlist": [
      "gemini_search_grounding"
    ],
    "needs": [
      {
        "need_id": "need_001",
        "source_node": "node_ancient_tech_01",
        "need_type": "world_model_expansion",
        "topic": "Ancient energy sources used by lost civilizations",
        "reason": "To enrich the character'\''s knowledge base for upcoming story arcs involving ancient technology.",
        "expected_use": "world_model_candidate",
        "allowed_provider_families": [
          "gemini_search_grounding"
        ]
      }
    ]
  },
  "query_plan": {
    "research_plan_id": "plan_ancient_tech_2024",
    "plan_summary": "Research plan focused on gathering detailed information about ancient energy sources and their applications."
  }
}'

Authentication

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

Path parameters

slugstringRequired

Request

This endpoint expects an object.

planner_inputobjectRequired

The typed research-needs input used to create the query plan. LoreOS revalidates it server-side before enqueueing runs.

query_planobjectRequired

LLM or operator-authored query plan; accepted queries become runs.

trigger_sourceenumOptionalDefaults to api

expand_queriesbooleanOptionalDefaults to true

Whether LoreOS should apply deterministic query expansion before enqueueing runs. Expansion can split valid multi-category place queries; it does not repair invalid queries or call providers.

max_expansions_per_queryintegerOptional0-4Defaults to 3

Maximum deterministic variants to generate per source query.

idempotency_prefixstring or nullOptional<=180 characters

Optional stable prefix. Defaults to app/character/query-plan identifiers.

Response

Successful Response

Errors

422

Unprocessable Entity Error