VEverdun
focus

Keep focusing (the answer to "Still focusing?")

The only thing that resets the check once it is due. At or after the check deadline the focus is dead: the release is materialized and this answers 409 focus_changed with the released record (a late Keep never revives it). A focus_id that is not the caller's, already released, or no longer inside the caller's current scope (it is then released as scope_lost) is 409 focus_changed; the body never describes an out-of-scope record.

post/focus/{focus_id}/keep

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/focus/{focus_id}/keep
  • Auth
    HTTP bearer

Path parameters

focus_idstring required

Response

Successful Response

idstring required

The focus generation id; a restart is a new id.

site_idstring required

The site the focus is on.

operator_idstring required

The focuser.

operator_namestring nullable

Their display name; null if the operator no longer exists.

started_atstring required

ISO 8601, UTC.

last_input_atstring required

Last accepted meaningful input or Keep (ISO 8601, UTC).

check_due_atstring required

last_input_at + FOCUS_CHECK_IDLE_SECONDS: when the console asks "Still focusing?".

check_deadlinestring required

check_due_at + FOCUS_CHECK_ANSWER_SECONDS: with no explicit Keep by then the server releases the focus (and treats it as released at once, before any sweep).

check_pendingboolean required

True while the check is due and unanswered (active records only).

check_due_in_secondsinteger required

Seconds until check_due_at, computed server-side: time it from this against the local clock at receipt.

check_deadline_in_secondsinteger required

Seconds until check_deadline, computed server-side.

state'active' | 'released' required

active while reserving alarms; released once it has ended.

released_atstring nullable

When the focus was released (ISO 8601, UTC); null while active.

release_reason'manual' | 'check_timeout' | 'disabled' | 'scope_lost' nullable

Why it was released; null while active.

Changes

No recorded changes to this operation across all 2 revisions of this API.