---
title: "Open a returned resource by its ordinary id"
method: POST
path: "/context/open"
tags: ["Context"]
---

# Open a returned resource by its ordinary id

`POST /context/open`

## Request

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

Pass ref (a handle or resource URL), or exactly one legacy artifactId, chatId, taskId, agreementId. Authorization is rechecked on every call. A saved reference is not authority. This is read-only: it never requests access or records an approval.

## 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

- ContextOpenResultSchema
  - `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
  - `page` ContextReadEnvelopeSchema
    - `type` string, required
    - `via` object, required
    - `items` object[], required
    - `hasMore` boolean, required
    - `nextCursor` string, nullable, required
    - `latestSequence` string, nullable

---

[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)