---
title: "Stop a Research Agent session"
method: POST
path: "/sessions/agents/{sessionId}/stop"
tags: ["Research Agent"]
---

# Stop a Research Agent session

`POST /sessions/agents/{sessionId}/stop`

Request an asynchronous interrupt using the same stop action as the Elicit web interface.

Stopping does not delete or permanently close the session. The session remains visible and may be continued later. When the response status is `stopping`, poll the events endpoint until a `session_stopped` event appears.

The operation is idempotent. If the session is already stopped or failed, it returns the existing state with `200 OK`.

### Example

```bash
curl -X POST https://elicit.com/api/v2/sessions/agents/{sessionId}/stop \
  -H "Authorization: Bearer elk_live_your_key_here"
```

## Path parameters

- `sessionId` string, uuid, required

## Response `200`

The session had already stopped or failed.

- StopAgentSessionResponse
  - `sessionId` string, required — Unique identifier for the research agent session.
  - `status` 'stopping' | 'stopped' | 'failed', required — "stopping" when a stop was queued (the session halts asynchronously; poll the events endpoint for the session_stopped event). "stopped" or "failed" when the session had already ended and no stop was needed.
  - `url` string, required — URL to view and continue the session in the Elicit web interface.

## Other responses

- `202` — The stop request was queued. Poll the events endpoint until the session is stopped.
- `401` — Authentication failed. The API key is missing, invalid, revoked, or expired.
- `403` — API access is not available on your current plan. Upgrade to Pro or above to use the API.
- `404` — The Research Agent API is not enabled for this account, or the session does not exist or belongs to another user.
- `429` — Rate limit exceeded. More than 100 requests per minute were received from your IP address; further requests are blocked for 5 minutes.
- `500` — An unexpected error occurred. Retry after a short delay.

---

[API](https://skmtc.dev/elicit/apis/elicit-api.md) · [All operations](https://skmtc.dev/elicit/apis/elicit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elicit/elicit-api/revisions/2b42624536e5/schema)