{
  "opencollection": "1.0.0",
  "info": {
    "name": "Amigo Account Prompt Logs API",
    "version": "0.1.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Prompt Logs",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List prompt logs for a workspace",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/prompt-logs",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "query",
                "description": "Conversation entity UUID (canonical identifier across all modalities — voice, text/web, sms, sim). Resolves text conversations through the durable ``world.conversations`` row, then falls back to the voice/call entity projection. Mutually exclusive with the ``call_sid`` query parameter."
              },
              {
                "name": "call_sid",
                "value": "",
                "type": "query",
                "description": "Direct conversation identifier as stored on the prompt-log event: Twilio CA-SID for voice calls, session_id UUID for text/sim sessions. Most callers should use ``conversation_id`` instead — this is kept for legacy callers and external systems that hold the SID directly. Mutually exclusive with ``conversation_id``."
              },
              {
                "name": "prompt_type",
                "value": "",
                "type": "query",
                "description": "Filter by prompt_type (e.g. engage_user, navigation, tool)"
              },
              {
                "name": "state_name",
                "value": "",
                "type": "query",
                "description": "Filter by HSM state_name at render time"
              },
              {
                "name": "from_ts",
                "value": "",
                "type": "query",
                "description": "Inclusive lower bound on effective_at"
              },
              {
                "name": "to_ts",
                "value": "",
                "type": "query",
                "description": "Exclusive upper bound on effective_at"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Max rows to return (default 20, max 200)"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Offset for pagination (max 10000)"
              }
            ]
          },
          "docs": "Lists ``prompt_log`` events emitted by agent-engine — full system prompt, conversation history, tool catalog, LLM model, and response — for auditing and debugging. Reads the Delta ``world_events`` ledger via Databricks SQL; typical latency is 1-5s with a 15s ceiling on cold-start.\n\n**Conversation filter**: pass ``conversation_id`` for the canonical mental model. Text conversations resolve from ``world.conversations``; voice/call IDs resolve through the projected conversation entity. ``call_sid``"
        }
      ]
    }
  ],
  "bundled": true
}