---
title: "Stop sharing an app connection with a workspace, or take back one API key's grant [write]"
method: DELETE
path: "/plugins/{name}/share"
---

# Stop sharing an app connection with a workspace, or take back one API key's grant \[write\]

`DELETE /plugins/{name}/share`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/plugins/{name}/share`
- Auth: HTTP bearer

app:<slug> only (422 not_shareable otherwise); the same fields as sharing, in the query. Without `api_key`, `workspace`'s sessions lose your connection of that app at once, as DELETE /universes/{slug}/connections/{id}. With `api_key` (a key id of the request's workspace, which `workspace` must name), that key can no longer call through it, as DELETE /connectors/connections/{id}/grants; `all_api_keys=true` takes back the grant to every key of that workspace. The connection itself stays connected. `connection_id` when you have several (else 409 connection_required); a workspace owner or admin may name another member's connection shared with `workspace`. 404 when it was not shared there. A workspace key is 403 person_required.

## Path parameters

- `name` string, required

## Query parameters

- `workspace` string, required
- `api_key` string
- `all_api_keys` boolean
- `connection_id` string

## Response `200`

No longer shared

- object
  - `plugin_id` string, required
  - `unshared` 'workspace' | 'api_key' | 'all_api_keys', required
  - `workspace` string
  - `api_key` string
  - `connection_id` string, required

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/plugins/:name/share/delete.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)