---
title: "Revoke a session share"
method: DELETE
path: "/sessions/{sessionId}/shares"
tags: ["Sessions"]
---

# Revoke a session share

`DELETE /sessions/{sessionId}/shares`

Revoke a read-only share by email. Removes either an active share (for a registered recipient) or a pending invitation. Only the session owner can revoke shares.

The operation is idempotent: revoking an email that isn't currently shared returns `revoked: false` with `200 OK`.

### Example

```bash
curl -X DELETE https://elicit.com/api/v2/sessions/{sessionId}/shares \
  -H "Authorization: Bearer elk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"email":"colleague@example.com"}'
```

## Path parameters

- `sessionId` string, uuid, required — The session ID (UUID) returned by the create endpoints and `GET /sessions`

## Request body

- object
  - `email` string, email, required — Email address whose share (or pending invite) should be revoked.

## Response `200`

The share was revoked, or there was nothing to revoke (idempotent).

- DeleteSessionShareResponse
  - `sessionId` string, required — Unique identifier for the session.
  - `email` string, required — Email address whose share was revoked.
  - `revoked` boolean, required — Whether an existing share or pending invite was removed. False when there was nothing to revoke (the call is idempotent either way).

## Other responses

- `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` — Session not found. The session ID is invalid or belongs to a different user (or, for an agent session, the Research Agent API is not enabled for this account).
- `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)