---
title: "List toolbox shares"
method: GET
path: "/toolbox/{id}/share"
tags: ["Toolboxes"]
---

# List toolbox shares

`GET /toolbox/{id}/share`

## Request

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

Lists who a toolbox is shared with. Cursor-paginated, and the only place the grant list is served — a toolbox may be granted to every member of the organization, so nothing else embeds it. Filter with `grantee_type`, search member names/emails and team names with `q`. Requires owner or `edit` access (own grant) — no `toolbox:manage` fallback.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `q` string
- `grantee_type` 'user' | 'team' | 'org'

## Headers

- `X-Organization-Id` string

## Response `200`

OK

- object
  - `result` object[], required
    - `id` string: Share id (`acl_…`), the `{aclId}` that `DELETE …/share/{aclId}` takes.
    - `grantee_type` 'user' | 'team' | 'org'
    - `grantee_id` string, nullable: Null for org-wide grants.
    - `level` 'view' | 'use' | 'edit'
    - `grantee` object: Resolved display data, so a page of grants needs no follow-up lookups.
      - `name` string, nullable
      - `email` string, nullable
      - `avatar_url` string, nullable: The person's picture: their stored profile picture, else a Gravatar URL (`d=404`, 96px) derived from their email (the address itself is not sent), else null. Draw initials when it is null or the image fails to load.
      - `member_count` integer, nullable: Team grants only: how many people the grant reaches.
    - `created_at` string, date-time
  - `next_cursor` string, nullable, required
  - `prev_cursor` string, nullable, 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)