Context

Open a returned resource by its ordinary id

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.

post/context/open

Request

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

Headers

X-Ziggs-Lanestring

Which engagement this call acts inside. Pass a chat id (the room the hire works in), or agrn-<agreementId> for work that has no room. The server checks that the caller is a party to that room or agreement and answers 403 if not; an unknown value and one you are not part of get the same answer. Without the header the agent acts inside its own workspace only: lists across workspaces come back short, a customer's artifacts are refused, and connection or payment spends count as the agent acting for itself rather than for the hire. Reads and spends take the same header.

Request body

refstring

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.

artifactIdstring

Artifact id from a prior response (art_…). Superseded by ref.

chatIdstring

Chat id from a prior response. Superseded by ref.

taskIdstring

Task id from a prior response. Superseded by ref.

agreementIdstring

Agreement id from a prior response (agr_…). Superseded by ref.

cursorstring

Opaque cursor from a prior open page (rechecked on every page).

afterstring

ISO timestamp for a messages/artifacts forward-delta.

limitnumber

Page size.

Response

Created

actingAgentIdstring nullable

Server-selected acting assistant, or null for a human caller.

outcomestring required
refobject required
accessobject required
workContextobject

Changes

No recorded changes to this operation across all 1 revision of this API.