Stop a run

cURL

curl -X POST https://api.exa.ai/agent/runs/<id>/stop \
  -H "x-api-key: $EXA_API_KEY"

{
  "id": "<string>",
  "object": "agent_run",
  "status": "queued",
  "stopReason": "schema_satisfied",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "request": {
    "query": "<string>",
    "systemPrompt": "<string>",
    "effort": "auto",
    "input": {
      "data": [
        {}
      ],
      "exclusion": [
        {}
      ]
    },
    "outputSchema": {},
    "previousRunId": "<string>",
    "metadata": {},
    "dataSources": [
      {
        "provider": "fiber"
      }
    ],
    "budget": {
      "maxCostDollars": 123,
      "maxDurationSeconds": 123
    }
  },
  "output": {
    "text": "<string>",
    "structured": true,
    "grounding": [
      {
        "field": "<string>",
        "citations": [
          {
            "url": "<string>",
            "title": "<string>"
          }
        ],
        "confidence": "low"
      }
    ]
  },
  "usage": {
    "agentComputeUnits": 1,
    "searches": 1,
    "emails": 1,
    "phoneNumbers": 1,
    "dataSources": {}
  },
  "costDollars": {
    "total": 1,
    "agentCompute": 1,
    "search": 1,
    "emails": 1,
    "phoneNumbers": 1,
    "dataSources": {}
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "requestId": "<string>",
  "error": "<string>",
  "tag": "<string>"
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

cURL

curl -X POST https://api.exa.ai/agent/runs/<id>/stop \
  -H "x-api-key: $EXA_API_KEY"

{
  "id": "<string>",
  "object": "agent_run",
  "status": "queued",
  "stopReason": "schema_satisfied",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "request": {
    "query": "<string>",
    "systemPrompt": "<string>",
    "effort": "auto",
    "input": {
      "data": [
        {}
      ],
      "exclusion": [
        {}
      ]
    },
    "outputSchema": {},
    "previousRunId": "<string>",
    "metadata": {},
    "dataSources": [
      {
        "provider": "fiber"
      }
    ],
    "budget": {
      "maxCostDollars": 123,
      "maxDurationSeconds": 123
    }
  },
  "output": {
    "text": "<string>",
    "structured": true,
    "grounding": [
      {
        "field": "<string>",
        "citations": [
          {
            "url": "<string>",
            "title": "<string>"
          }
        ],
        "confidence": "low"
      }
    ]
  },
  "usage": {
    "agentComputeUnits": 1,
    "searches": 1,
    "emails": 1,
    "phoneNumbers": 1,
    "dataSources": {}
  },
  "costDollars": {
    "total": 1,
    "agentCompute": 1,
    "search": 1,
    "emails": 1,
    "phoneNumbers": 1,
    "dataSources": {}
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "requestId": "<string>",
  "error": "<string>",
  "tag": "<string>"
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "type": "INVALID_REQUEST",
    "code": "INVALID_REQUEST",
    "message": "<string>"
  }
}

If the run is still active, the agent wraps up and completes the run early with the results gathered so far. The run ends with status completed and stopReason: stopped. You are billed for usage accrued before the stop. If the run has already reached a terminal status (completed, failed, or cancelled), the endpoint returns the existing run unchanged. To terminate a run immediately without returning any results, use cancel instead.

Only supported on Agent Ultra runs (effort: "ultra").

Get your Exa API key

Create a key in the dashboard. New accounts start with free credits.

Authorizations

x-api-key

string

header

required

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

Path Parameters

string

required

Agent run ID.

Required string length: 1 - 200

Pattern: ^[A-Za-z0-9_.:-]+$

Response

Agent run

string

required

Agent run ID. New run IDs are returned with the agent_run_ prefix.

Required string length: 1 - 200

Pattern: ^[A-Za-z0-9_.:-]+$

object

string

required

Allowed value: "agent_run"

status

enum<string>

required

Available options:

queued,

running,

completed,

failed,

cancelled

stopReason

enum<string> | null

required

Why the run stopped. null while the run is queued or running.

Available options:

schema_satisfied,

budget_reached,

time_limit_reached,

stopped,

error,

cancelled

createdAt

string<date-time>

required

When the run was created

completedAt

string<date-time>

required

request

object | null

required

Canonicalized request fields stored with the run.

Show child attributes

output

object

required

Show child attributes

usage

object

required

Show child attributes

costDollars

object

required

Show child attributes

Search

Contents

Agent

Monitors

Answer

Batch

Team Management

Websets

Stop a run

Get your Exa API key

Authorizations

Path Parameters

Response