Skip to content
SHAMPOO

Tool catalogue

scratch_get

Read · Ordinary · Tasks and notes

scratch_get

  • Category: tasks
  • Access: read
  • Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Read one own scratch note by id.

Arguments

Required: id.

  • id. Note: Scratch id.

Result

Full scratch row JSON.

Boundaries

Owner-private: owner credential only, no star bypass. Misses and foreign rows read as not found. Project is context, never a sharing scope.

Lifecycle / side effects

Active <-> archived; lifecycle only, no delete verb exists.

Errors

Bad ids/transitions rejected. Failures move nothing (atomic).

Example

{
  "id": "..."
}

Result shape:

{
  "status": "active"
}

See also

scratch_list.

On this page