AlmondTill/G3N API

On this page

needsAttention

query · in the family Your own session

What it does

Your own worklist in this organization — overdue tasks first, then upcoming, then the rest, ranked for you.

Render verbatim. Requires authentication (user sessions — an api key has no worklist).

What happens

Read-only and personal: it shows your work, never anyone else’s.

Who may call it

Capability area: Your own session — What every signed-in person may do for themselves — their session, their profile and their own work.

Returns

NeedsAttentionEntry [NeedsAttentionEntry!]! — Render VERBATIM — the server already ranked (overdue first; no client filtering by construction).

Example request

query ExampleNeedsAttention {
  needsAttention {
    kind
    targetType
    targetId
    caption
    reason
    at
  }
}

Example response

{
  "data": {
    "needsAttention": [
      {
        "kind": "<kind>",
        "targetType": "<target type>",
        "targetId": "01900000-0000-7000-8000-446adfd50000",
        "caption": "Blue jeans",
        "reason": "Correcting a miscount.",
        "at": "<at>"
      }
    ]
  },
  "extensions": {
    "at": {
      "callId": "01EXAMPLE-CALL-ID",
      "version": {
        "requested": null,
        "serviced": {
          "name": "genesis",
          "number": 0
        }
      }
    }
  }
}

Errors this call can answer