---
title: "Explain access to a returned resource without opening it"
method: POST
path: "/context/access/explain"
tags: ["Context"]
---

# Explain access to a returned resource without opening it

`POST /context/access/explain`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/context/access/explain`
- Auth: HTTP bearer

Same reference as POST /context/open. Read-only. Does not return content, does not request access, and does not approve anything.

## Headers

- `X-Ziggs-Lane` string

## Request body

- ContextOpenDto
  - `ref` string: What to open: a handle such as T7K2QXD (task T, agreement A, chat C, artifact F), in any case; a Ziggs web URL that contains one; or an older id (task_…, agr_…, art_…, or a 24-letter chat id). The kind is read from it.
  - `artifactId` string: Artifact id from a prior response (art_…). Superseded by ref.
  - `chatId` string: Chat id from a prior response. Superseded by ref.
  - `taskId` string: Task id from a prior response. Superseded by ref.
  - `agreementId` string: Agreement id from a prior response (agr_…). Superseded by ref.
  - `cursor` string: Opaque cursor from a prior open page (rechecked on every page).
  - `after` string: ISO timestamp for a messages/artifacts forward-delta.
  - `limit` number: Page size.

## Response `201`

Created

- ContextExplainResultSchema
  - `actingAgentId` string, nullable: Server-selected acting assistant, or null for a human caller.
  - `actions` ResourceActionSchema[], required
    - `action` string, required
    - `state` 'available' | 'needs_decision' | 'unavailable' | 'not_evaluated', required
    - `tool` string
    - `args` object
    - `required` string[]
    - `reasonCode` string
    - `scope` object
    - `recovery` ResourceActionCallSchema
      - `tool` string, required
      - `args` object, required
      - `required` string[]
      - `approvers` object[]
        - `id` string
        - `name` string, nullable
        - `role` string
      - `unavailableReason` string
  - `outcome` string, required
  - `ref` object, required
  - `access` object, required
  - `workContext` object
  - `reason` object: The grant that admits this read, and the instrument it rests on. Absent when the read is refused or no grant is the reason.

---

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