facade

Inspect Assistant

Read your chats with Vruum and the workspace's Agent work. Read-only.

  • list: no id; optional payload={before_updated_at, before_id, limit}. Your chats in this workspace, newest first. For the next page pass the last item's updated_at and id.

  • read: id=chat UUID; optional payload={before_sequence, limit}. The chat's messages with full text (newest page first), its turns with their state, and its record changes (items) with their Undo state and each answer's current rating. Use next_before_sequence for earlier messages.

  • browser_source: id=snapshot UUID; optional payload={offset, link_offset, element_offset}. Read saved browser text in 12,000-character pages, links in groups of 10, and controls in groups of 20. Follow next_offset, next_link_offset and next_element_offset independently. This is private observed evidence, not browsing authority.

  • jobs: no id; optional payload={scope: everyone|mine, view: current|history}. The workspace's Agent work as outcomes: one row per objective with agent work (kinds Outreach, Content, Plan inside; contributing objectives under their parent) or per one-off request. Each row has progress, what each kind is doing now, and the decisions it waits for: needs_you are yours to make, waiting_for names who else decides.

  • job: id=row key (objective:<id> or request:<id>) or a Delegation UUID. The row plus what each kind was handed, the newest 20 journal entries (recorded facts and the agent's labelled notes) and, for a request, its saved steps and result (the analysis and drafts it prepared, each with its own approval). Every member reads it; reading never resumes work.

A turn in state running is still working; read again for its answer. Messages, changes and ratings are the same ones the app's chat panel shows.

post/api/facade/inspect_assistant

Request

  • Base URL: https://api.vruum.ai
  • URL: https://api.vruum.ai/api/facade/inspect_assistant
  • Auth: HTTPBearer (a scheme the document does not define)

Request body

actionstring required

The operation to perform — see the tool description for the action vocabulary and each action's id/payload semantics.

payloadobject nullable

Action-specific fields, validated by the underlying route's own schema (a bad field 422s with that route's precise errors). See the tool description per action.

itemsobject[] nullable

For create-like actions only: an array of per-item payloads processed in order with per-item results (max 100). Mutually exclusive with id and payload.

Response

Successful Response

unknown required

Changes

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