{
  "url": "https://telipot.com/catalog/tasks/exa.web.research.list",
  "id": "exa.web.research.list",
  "name": "Web research runs on the account, newest first, with status",
  "provider": {
    "slug": "exa",
    "name": "Exa"
  },
  "capability": "web.research.list",
  "platform": "web",
  "kind": "account",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "confidence": "unknown",
    "source": "docs",
    "sourceUrl": "https://exa.ai/docs/admin/pricing",
    "checked": "2026-10-05",
    "note": "The pricing page lists no rate for listing runs; the billing page says only that reads of run lists do not count against QPS.",
    "type": "per_call",
    "state": "unknown",
    "label": "Price unknown",
    "detail": "Not listed, not free"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "byoc",
  "live": true,
  "summary": "List Agent runs for your team, ordered from newest to oldest.",
  "method": "GET",
  "path": "/agent/runs",
  "host": "https://api.exa.ai",
  "docsUrl": "https://exa.ai/docs/reference/agent-api/list-runs",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in header as x-api-key",
    "short": "api_key · x-api-key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "verified",
    "label": "Verified on 2026-10-05",
    "detail": "We ran a real request and checked the answer. This is a spot check, not a success rate."
  },
  "input": [
    {
      "name": "limit",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "1 to 100",
        "default 20"
      ],
      "note": "Number of results per page."
    },
    {
      "name": "cursor",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [
        "1 to 200"
      ],
      "note": "Where to resume, the nextCursor of the previous page."
    }
  ],
  "sampleInput": {
    "limit": 1
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "description": "Number of results per page.",
        "default": 20,
        "minimum": 1,
        "maximum": 100
      },
      "cursor": {
        "type": "string",
        "description": "Where to resume, the nextCursor of the previous page.",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "additionalProperties": false
  },
  "output": [
    {
      "name": "object",
      "type": "string"
    },
    {
      "name": "data",
      "type": "object[]"
    },
    {
      "name": "hasMore",
      "type": "boolean"
    },
    {
      "name": "nextCursor",
      "type": "string | null",
      "description": "Pass as cursor to read the next page"
    }
  ],
  "outputSchema": {
    "type": "object",
    "required": [
      "object",
      "data",
      "hasMore",
      "nextCursor"
    ],
    "properties": {
      "object": {
        "type": "string"
      },
      "data": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "object",
            "status",
            "stopReason",
            "createdAt",
            "completedAt",
            "request",
            "output",
            "usage",
            "costDollars"
          ],
          "properties": {
            "id": {
              "type": "string",
              "description": "Run id with the agent_run_ prefix"
            },
            "object": {
              "type": "string"
            },
            "status": {
              "type": "string",
              "description": "queued, running, completed, failed or cancelled"
            },
            "stopReason": {
              "type": [
                "string",
                "null"
              ],
              "description": "Why the run stopped; null while it is queued or running"
            },
            "createdAt": {
              "type": "string"
            },
            "completedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "request": {
              "type": [
                "object",
                "null"
              ],
              "description": "The request fields stored with the run"
            },
            "output": {
              "type": "object",
              "required": [
                "text",
                "structured",
                "grounding"
              ],
              "properties": {
                "text": {
                  "type": "string",
                  "description": "Natural-language answer or summary"
                },
                "structured": {
                  "description": "JSON shaped by outputSchema; null when no schema was given"
                },
                "grounding": {
                  "type": "array",
                  "description": "Field-level citations",
                  "items": {
                    "type": "object",
                    "required": [
                      "field",
                      "citations"
                    ],
                    "properties": {
                      "field": {
                        "type": "string"
                      },
                      "citations": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string"
                            },
                            "title": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "confidence": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    }
                  }
                }
              }
            },
            "usage": {
              "type": "object",
              "required": [
                "agentComputeUnits",
                "searches",
                "emails",
                "phoneNumbers"
              ],
              "properties": {
                "agentComputeUnits": {
                  "type": "number"
                },
                "searches": {
                  "type": "integer"
                },
                "emails": {
                  "type": "integer"
                },
                "phoneNumbers": {
                  "type": "integer"
                },
                "dataSources": {
                  "type": "object"
                }
              }
            },
            "costDollars": {
              "type": "object",
              "required": [
                "total",
                "agentCompute",
                "search",
                "emails",
                "phoneNumbers"
              ],
              "properties": {
                "total": {
                  "type": "number"
                },
                "agentCompute": {
                  "type": "number"
                },
                "search": {
                  "type": "number"
                },
                "emails": {
                  "type": "number"
                },
                "phoneNumbers": {
                  "type": "number"
                },
                "dataSources": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "hasMore": {
        "type": "boolean"
      },
      "nextCursor": {
        "type": [
          "string",
          "null"
        ],
        "description": "Pass as cursor to read the next page"
      }
    }
  },
  "example": {
    "file": "examples/exa.web.research.list.json",
    "json": {
      "object": "masked",
      "data": [
        {
          "id": "masked",
          "object": "masked",
          "status": "masked",
          "stopReason": null,
          "createdAt": "masked",
          "completedAt": null,
          "request": {},
          "output": {
            "text": "masked",
            "structured": null,
            "grounding": []
          },
          "usage": {
            "agentComputeUnits": 0,
            "searches": 3,
            "emails": 0,
            "phoneNumbers": 0
          },
          "costDollars": {
            "total": 0.012,
            "agentCompute": 0,
            "search": 0.012,
            "emails": 0,
            "phoneNumbers": 0
          }
        }
      ],
      "hasMore": true,
      "nextCursor": "masked"
    }
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run exa.web.research.list \\\n  --input-json '{\"limit\":1}'",
    "http": "curl https://api.telipot.com/v1/tasks/exa.web.research.list/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"limit\":1}'",
    "quote": "telipot run exa.web.research.list \\\n  --input-json '{\"limit\":1}' \\\n  --quote"
  },
  "siblings": []
}