impri_push_action
Submit an action to a human-approval inbox for review. The operator approves, rejects, or edits it from their web or mobile inbox.
Instructions
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
| Name | Required | Description | Default |
|---|---|---|---|
| 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. |