---
title: "Read visibility, explicit grants, and eligible organization participants"
method: GET
path: "/handovers/{id}/access"
---

# Read visibility, explicit grants, and eligible organization participants

`GET /handovers/{id}/access`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/handovers/{id}/access`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Handover access state

- HandoverAccessEnvelope
  - `data` HandoverAccess, required
    - `handoverId` string, required
    - `visibility` 'workspace' | 'restricted', required
    - `canManage` boolean, required
    - `participants` HandoverAccessParticipant[], required
      - `principalId` string, required
      - `displayName` string, required
      - `type` 'human' | 'agent' | 'system', required
      - `organizationRole` 'owner' | 'member', required
      - `grantRole` 'viewer' | 'editor' | 'owner' | 'null', nullable
      - `isCreator` boolean, required
      - `isCurrentActor` boolean, required

## Other responses

- `404`: Request error

---

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