Browse the candidate's authored reasoning/premise trail

Returns public-eligible OB1 observations — the dated, authored "why and lessons" notes behind the profile (types observation/idea/task), each with a stable URL for citation. Every item carries an "authored" boolean separating hand-written notes from machine-generated sync/telemetry entries; filter with authored=1 or authored=0. Excludes the git-sync changelog ledger (type=reference) by default; pass type=reference to read it. Private notes are always excluded.

get/observations

Request

  • Base URL: https://agent.yuens.me
  • URL: https://agent.yuens.me/observations
  • Auth: none declared

Query parameters

topicstring

Filter by an OB1 topic tag (case-insensitive)

type'observation' | 'idea' | 'task' | 'reference'

Override the default type filter (observation/idea/task). Use "reference" for the git/changelog ledger.

sincestring date

Only observations on or after this date (YYYY-MM-DD)

authoredstring

Restrict to authored notes or to machine-generated sync/telemetry entries. Truthy: 1, true, yes, or a bare ?authored with no value. Falsy: 0, false, no. Case-insensitive; an unrecognized value is ignored. Omitted returns both classes — the default listing is unchanged. Applied before the limit, so authored=1&limit=25 yields 25 authored notes.

limitinteger

Response

A list of public-eligible observations, each individually addressable

countinteger
scopeobject

The active topic scope: {topic}, {topics}, or {recent:true}

typesstring[]

The thought types included (default observation/idea/task, or the explicit ?type)

authoredboolean

Echo of the ?authored filter. Present only when the filter was requested — its absence on a filtered request identifies a deployment predating this field.

notestring

Human-readable description of what this surface returns

Changes

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