Retired. Refuses with attention_retired.

Attention decisions retired with the attention engine. A body that does not match the schema is refused for its fields; any other request refuses with attention_retired and offers the opening, reviews.update, and a note about the record.

post/v1/attention/update

Request

  • Base URL: https://api.candor.money
  • URL: https://api.candor.money/v1/attention/update
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Stable opaque identity for one logical POST. Reuse only with the same method, path, actor, and body for transport retries. A completed receipt replays its original result, including a refusal; changed input with the same key is rejected. After a refused action and access recovery, use a new key for the new attempt. Follow retryable and recovery guidance if the operation is still running or its outcome is unknown.

Request body

situation_idstring required

The situation's id from attention.list, conversations.get, or an opening's attention item. A decision on a folded situation covers its whole card.

state'deferred' | 'dismissed' | 'settled' | 'confirmed' | 'asked' | 'active' required

deferred sets it aside until revisit_at. dismissed holds it until it grows. settled marks it handled. confirmed records what shows it holds for this household, from the records, notes, or the user's answer; the user's dashboard states a finding only once it is confirmed. asked records the question you put to the user about something only they can tell; it stays on the list and their dashboard holds it until a later decision. active restores it from any earlier decision.

reasonstring

The user's words for the decision, such as "Starting estimated payments in January", or your question for asked. Required except to restore. The review never reads it.

note_idstring

A context note in this workspace that keeps what the reason says about the household, linked to the decision.

Example request

{
  "situation_id": "tax.estimated_payments",
  "reason": "Starting estimated payments in January"
}

Response

Not returned; every request refuses with attention_retired.

schema_versionstring required
generated_atstring date-time required
request_idstring required
status'success' | 'partial_success' | 'action_required' | 'error' required
user_messagestring

Optional concise user-safe message the calling agent may adapt.

warningsobject[] required
dataobject nullable required

Operation-specific result data, or null when the request ends in an error.

Changes

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