chat.yakka.getTimelineAround

A window centred on a sequence, for opening a permalink to an old message. Paging backwards from the tail to reach something linked from months ago would be many round trips, which is the entire reason this is a separate method rather than a parameter.

Repository @yakka.chat did:plc:wpjoy2orkqq5m65vq7gg7liz namespace authority
Details · query
Kindquery
Authorityyakka.chat
Indexed

Query

query · GET

Parameters

query string

channel

requiredstring

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 50

seq

requiredinteger

The sequence to centre on. It need not still exist — a deleted message keeps its sequence (ADR 0010), so a permalink to one still lands in the right place.

  • minimum: 1

Output

application/json

Errors

ChannelNotFound

No description in schema.

ChannelForbidden

No description in schema.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A page of a channel's timeline, newest first, ordered by view sequence (ADR 0012). Paging is by sequence and never by timestamp or record key: TIDs order a repo, never a channel, and two authors' clocks are not comparable.

  • Lists messages in a channel or in a thread, newest first by default. Messages from the repo-backed channel this one was migrated from are included and marked legacy. Messages moved in from another space are included in their move order, and messages moved out are absent.