get_item
Retrieve a task, habit, chore, or event by UUID, sequence number, canonical ref, URL, or GitHub alias. Returns compact details or full record with history and comments.
Instructions
Fetch a single item (Task / Habit / Chore / Event) by any reference.
item accepts any Ref input form and is resolved transparently:
a UUID (
GET /items/{id});a Sequence shorthand --
#123or bare123. This resolves against your personal org only, by design. For an item in a shared org, name it by its Canonical ref (acme-123) or its App URL instead -- both resolve across orgs;a Canonical ref (
slug-123, e.g.u-1y0e2v-123);an App URL (
https://app.defernowork.com/o/{org_slug}/items/{seq-or-id});the unambiguous GitHub Alias
owner/repo#N(it carries a/, so it can't be confused with a Canonical ref) -- auto-routed to the by-alias endpoint.
Deferno-# vs GitHub-# ambiguity. A bare #N always means a
Deferno Sequence shorthand here; it is NOT inferred as a GitHub issue.
Likewise an ambiguous string like ABC-223 collides with a Canonical
ref and is therefore NOT auto-routed to alias resolution. Inferring
which a user means from conversation is the job of a future
context-adaptive classifier (see CONTEXT.md "Flagged ambiguities"),
not this tool. Until then, use as_alias=true to force the alias path.
Args:
item: Any Ref input form (or, with as_alias=true, a raw alias).
full: When true, return the complete record (action history,
comments, children, mood, attachments, ...) instead of the
default compact projection.
as_alias: When true, BYPASS the Ref classifier and look item
up directly via GET /items/by-alias/{item}. This is the
explicit escape-hatch for ambiguous external aliases (e.g.
ABC-223) that the classifier deliberately will not
auto-route. The unambiguous GitHub form owner/repo#N already
routes to by-alias WITHOUT this flag.
Returns a compact projection by default (a small whitelist of
fields, including description). Pass full=true for the complete
record (action history, comments, children, mood, attachments, ...).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | Yes | ||
| full | No | ||
| as_alias | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |