Impri

Push action for approval

impri_push_action

Submit an action to the Impri human-approval inbox.

The action appears in the operator's web and mobile inbox as a card with a title, formatted preview, and optional tap-to-edit fields. The operator approves or rejects with one tap; you poll for the decision with impri_await_decision.

Returns { action_id, status: "pending", inbox_url }. Save action_id — you need it for all follow-up calls.

Example — send a draft Reddit reply for review: kind: "reddit.comment" title: "Reply: Why is resume advice so conflicting?" preview: { format: "markdown", body: "The advice conflicts because different advisors optimise for different audiences..." } target_url: "https://reddit.com/r/cscareerquestions/comments/..." editable: ["preview.body"] // lets the reviewer tweak wording before approving

Input Schema

TableJSON Schema

Name	Required	Description
`kind`	Yes	Taxonomy label used for inbox filtering (e.g. 'reddit.comment', 'email.send', 'blog.publish'). Free-form; choose a consistent scheme.
`title`	Yes	Short headline shown in the inbox card. Keep it under 120 characters.
`payload`	No	Opaque data echoed back in the webhook callback — useful for storing context (e.g. Reddit post id, draft id, queue position). Not shown to the reviewer.
`preview`	Yes	The content the reviewer reads before deciding.
`editable`	No	Dot-notation fields the reviewer may edit before approving (e.g. ['preview.body']). The final edited values are echoed back in the approved action.
`expires_in`	No	Seconds until the action auto-expires (default 86400 = 24 h). After expiry the status becomes 'expired' and no decision can be made.
`target_url`	No	URL the reviewer can open for context (e.g. the Reddit thread, the email draft). Optional but strongly recommended.
`idempotency_key`	No	Stable key to prevent duplicate submissions on retry. The same key within 24 h returns the original action instead of creating a new one.