VEverdun
focus

Meaningful input from the focuser (resets the idle check)

The console sends this on meaningful input, throttled to about one per 10 s (what counts is the console's call; a live call or open voice session should keep pinging). Accepted only BEFORE the check is due; once the check is showing it is ignored (200 with the current record), because only an explicit Keep answers it. At or after the check deadline the focus is dead: 409 focus_changed with the released record. A focus_id that is not the caller's is 409 focus_changed with the caller's own current focus or null.

post/focus/{focus_id}/input

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}/input
  • 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.