{
  "url": "https://telipot.com/catalog/tasks/exa.web.research.cancel",
  "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": []
}