kythene.v1.KytheneService

CatchUp

Catchup returns what changed in your visible spaces since THIS credential (this instance) last looked - a session that opens caught up. It excludes your own instance's writes but includes the same user's other instances' and teammates'. Reading it advances this instance's cursor (peek to read without consuming). Call it at the start of a session.

post/kythene.v1.KytheneService/CatchUp

Request

  • Base URL: https://kythene.com (the document declares no server; this is the origin it was published from)
  • URL: https://kythene.com/kythene.v1.KytheneService/CatchUp
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

peekboolean

peek reads the delta WITHOUT advancing the cursor (a non-consuming check). Default (false) is the normal catch-up: reading advances the cursor.

limitinteger

limit caps the digest (default 50). The overflow is reported as more.

Response

Success

moreinteger

more is the count of entries beyond limit ("and N more").

firstLookboolean

first_look is true when this agent had no cursor yet: the watermark is set to now and the digest is empty (a brand-new agent has no "while you were away" window).

Example response

{
  "items": [
    {
      "at": "2023-01-15T01:30:15.01Z"
    }
  ],
  "actions": [
    {
      "createdAt": "2023-01-15T01:30:15.01Z",
      "updatedAt": "2023-01-15T01:30:15.01Z"
    }
  ]
}

Changes

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