---
title: "Inspect document access"
method: GET
path: "/v1beta/documents/{document_id}/capabilities"
tags: ["Access Requests"]
---

# Inspect document access

`GET /v1beta/documents/{document_id}/capabilities`

Returns the caller's permissions and any access policies on a document.

## Path parameters

- `document_id` string, required — Document ID.

## Response `200`

Success

- InspectAccessResponse — InspectAccessResponse contains the caller's permissions.
  - `document_id` string — Document ID.
  - `permission_set` DocumentPermissionSet — DocumentPermissionSet contains the permissions the authenticated user has on a document.
    - `attach_policy` boolean
    - `comment_private` boolean
    - `comment_public` boolean
    - `copy_content` boolean
    - `create_version` boolean
    - `export` boolean
    - `grant_access` boolean
    - `list_versions` boolean
    - `manage_access` boolean
    - `open` boolean
    - `screenshot` boolean
    - `trash` boolean
    - `view` boolean
    - `view_analytics` boolean
    - `view_leads` boolean
    - `view_timeline` boolean

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed - missing or invalid API key
- `403` — Authorization failed - valid key but insufficient permissions
- `404` — Resource not found
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/factify-inc/apis/factify-api.md) · [All operations](https://skmtc.net/factify-inc/apis/factify-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factify-inc/factify-api/revisions/8baabdfb82bf/schema)