{
  "opencollection": "1.0.0",
  "info": {
    "name": "Letta Admin Internal Runs API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Internal Runs",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Runs",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.letta.com/v1/_internal_runs/",
            "params": [
              {
                "name": "run_id",
                "value": "",
                "type": "query",
                "description": "Filter by a specific run ID."
              },
              {
                "name": "agent_id",
                "value": "",
                "type": "query",
                "description": "The unique identifier of the agent associated with the run."
              },
              {
                "name": "agent_ids",
                "value": "",
                "type": "query",
                "description": "The unique identifiers of the agents associated with the run. Deprecated in favor of agent_id field."
              },
              {
                "name": "statuses",
                "value": "",
                "type": "query",
                "description": "Filter runs by status. Can specify multiple statuses."
              },
              {
                "name": "background",
                "value": "",
                "type": "query",
                "description": "If True, filters for runs that were created in background mode."
              },
              {
                "name": "stop_reason",
                "value": "",
                "type": "query",
                "description": "Filter runs by stop reason."
              },
              {
                "name": "template_family",
                "value": "",
                "type": "query",
                "description": "Filter runs by template family (base_template_id)."
              },
              {
                "name": "step_count",
                "value": "",
                "type": "query",
                "description": "Filter runs by step count. Must be provided with step_count_operator."
              },
              {
                "name": "step_count_operator",
                "value": "",
                "type": "query",
                "description": "Operator for step_count filter: 'eq' for equals, 'gte' for greater than or equal, 'lte' for less than or equal."
              },
              {
                "name": "tools_used",
                "value": "",
                "type": "query",
                "description": "Filter runs that used any of the specified tools."
              },
              {
                "name": "before",
                "value": "",
                "type": "query",
                "description": "Run ID cursor for pagination. Returns runs that come before this run ID in the specified sort order"
              },
              {
                "name": "after",
                "value": "",
                "type": "query",
                "description": "Run ID cursor for pagination. Returns runs that come after this run ID in the specified sort order"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of runs to return"
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "Sort order for runs by creation time. 'asc' for oldest first, 'desc' for newest first"
              },
              {
                "name": "order_by",
                "value": "",
                "type": "query",
                "description": "Field to sort by"
              },
              {
                "name": "active",
                "value": "",
                "type": "query",
                "description": "Filter for active runs."
              },
              {
                "name": "ascending",
                "value": "",
                "type": "query",
                "description": "Whether to sort agents oldest to newest (True) or newest to oldest (False, default). Deprecated in favor of order field."
              },
              {
                "name": "project_id",
                "value": "",
                "type": "query",
                "description": "Filter runs by project ID."
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "query",
                "description": "Filter runs by conversation ID."
              },
              {
                "name": "duration_percentile",
                "value": "",
                "type": "query",
                "description": "Filter runs by duration percentile (1-100). Returns runs slower than this percentile."
              },
              {
                "name": "duration_value",
                "value": "",
                "type": "query",
                "description": "Duration value in nanoseconds for filtering. Must be used with duration_operator."
              },
              {
                "name": "duration_operator",
                "value": "",
                "type": "query",
                "description": "Comparison operator for duration filter: 'gt' (greater than), 'lt' (less than), 'eq' (equals)."
              },
              {
                "name": "start_date",
                "value": "",
                "type": "query",
                "description": "Filter runs created on or after this date (ISO 8601 format)."
              },
              {
                "name": "end_date",
                "value": "",
                "type": "query",
                "description": "Filter runs created on or before this date (ISO 8601 format)."
              }
            ]
          },
          "docs": "List all runs."
        }
      ]
    }
  ],
  "bundled": true
}