---
title: "Revoke a toolbox share"
method: DELETE
path: "/toolbox/{id}/share/{aclId}"
tags: ["Toolboxes"]
---

# Revoke a toolbox share

`DELETE /toolbox/{id}/share/{aclId}`

## Request

- Base URL: `https://api.elaichi.ai`
- URL: `https://api.elaichi.ai/toolbox/{id}/share/{aclId}`
- Auth: HTTP bearer

Revokes a share on a toolbox. The grantee loses access immediately — including every tool they reached only through this delegation. Rejects a dynamic id with 400. Requires `can_revoke_share` (`can_share`, i.e. `edit` access plus `toolbox:share`) — no `toolbox:manage` fallback.

## Path parameters

- `id` string, required
- `aclId` string, required

## Headers

- `X-Organization-Id` string

## Response `200`

Success

- Success
  - `success` boolean, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/elaichi/apis/elaichi-api.md) · [All operations](https://skmtc.dev/elaichi/apis/elaichi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elaichi/apis/elaichi-api/revisions/b22cfb7b6d15?raw)