---
title: "Disable Share"
method: DELETE
path: "/voice/sharing/{agentId}/share"
tags: ["Voice Agent Sharing"]
---

# Disable Share

`DELETE /voice/sharing/{agentId}/share`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/voice/sharing/{agentId}/share`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### Disable Share

Requires the OWNER or ADMIN role. Turns off public sharing and clears shareToken/shortCode -- a later Enable Share issues new ones, so any previously distributed share link stops working permanently, not just while disabled.

## Path parameters

- `agentId` string, required

## Response `200`

OK

- object
  - `status` 'success'
  - `message` string

## Other responses

- `403`: Caller's role is not OWNER or ADMIN
- `404`: Agent not found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)