{
  "url": "https://telipot.com/catalog/capabilities/web.research.cancel",
  "id": "web.research.cancel",
  "description": "Stop a web research run before it finishes",
  "platform": "web",
  "providers": [
    {
      "slug": "exa",
      "name": "Exa"
    }
  ],
  "tasks": 1,
  "taskPages": [
    {
      "id": "exa.web.research.cancel",
      "name": "Cancel a web research run by its id",
      "provider": {
        "slug": "exa",
        "name": "Exa"
      },
      "capability": "web.research.cancel",
      "platform": "web",
      "kind": "action",
      "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 route bills the usage a run accrued before it was cancelled, and the pricing page lists no rate for cancelling itself.",
        "type": "per_call",
        "state": "unknown",
        "label": "Price unknown",
        "detail": "Not listed, not free"
      },
      "providers": 1,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true,
      "summary": "Cancel a queued or running Agent run immediately without returning any results. You are billed for usage accrued before cancellation. If the run has already reached a terminal status, the API returns the existing run.",
      "method": "POST",
      "path": "/agent/runs/{id}/cancel",
      "host": "https://api.exa.ai",
      "docsUrl": "https://exa.ai/docs/reference/agent-api/cancel-a-run",
      "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": "untestable",
        "label": "Untestable",
        "detail": "needs the id of a research task that costs money to start"
      },
      "input": [
        {
          "name": "id",
          "location": "pathParams",
          "type": "string",
          "required": true,
          "constraints": [
            "1 to 200"
          ],
          "note": "Agent run id, as returned when the run was created. Ids carry the agent_run_ prefix."
        }
      ],
      "sampleInput": {
        "id": "agent_run_01j"
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Agent run id, as returned when the run was created. Ids carry the agent_run_ prefix.",
            "examples": [
              "agent_run_01j"
            ],
            "minLength": 1,
            "maxLength": 200
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      },
      "output": [
        {
          "name": "id",
          "type": "string",
          "description": "Run id with the agent_run_ prefix"
        },
        {
          "name": "object",
          "type": "string"
        },
        {
          "name": "status",
          "type": "string"
        },
        {
          "name": "stopReason",
          "type": "string | null",
          "description": "Why the run stopped; null while it is queued or running"
        },
        {
          "name": "createdAt",
          "type": "string"
        },
        {
          "name": "completedAt",
          "type": "string | null"
        },
        {
          "name": "request",
          "type": "object | null",
          "description": "The request fields stored with the run"
        },
        {
          "name": "output",
          "type": "object"
        },
        {
          "name": "usage",
          "type": "object"
        },
        {
          "name": "costDollars",
          "type": "object"
        }
      ],
      "outputSchema": {
        "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",
            "const": "agent_run"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "completed",
              "failed",
              "cancelled"
            ]
          },
          "stopReason": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "schema_satisfied",
                  "budget_reached",
                  "time_limit_reached",
                  "stopped",
                  "error",
                  "cancelled"
                ]
              },
              {
                "type": "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": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "low",
                            "medium",
                            "high"
                          ]
                        },
                        {
                          "type": "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"
              }
            }
          }
        }
      },
      "commands": {
        "mode": "run",
        "cli": "telipot run exa.web.research.cancel \\\n  --input-json '{\"id\":\"agent_run_01j\"}'",
        "http": "curl https://api.telipot.com/v1/tasks/exa.web.research.cancel/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"id\":\"agent_run_01j\"}'",
        "quote": "telipot run exa.web.research.cancel \\\n  --input-json '{\"id\":\"agent_run_01j\"}' \\\n  --quote"
      },
      "siblings": []
    }
  ]
}