> ## Documentation Index
> Fetch the complete documentation index at: https://docs.origami.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Job needs input

> Origami POSTs this event when a v3 Job pauses for
clarification (`data.needs_input.questions`) or a human
step (`data.needs_input.handoff`). Answer questions with
`POST /api/v3/jobs/{job_id}/input`. A handoff URL is for
the user — Origami resumes the Job itself after the
in-app step completes.

**Default in the picker:** off.




## OpenAPI

````yaml /openapi-webhooks-jobs.yaml webhook job.needs_input
openapi: 3.1.0
info:
  title: Origami Job webhooks
  version: '3.0'
  description: |
    Outbound events Origami POSTs to your servers when a v3 API Job
    changes status. These events are v3-only — they fire for searches,
    fetches, enrichment, campaign drafts, domain purchases, mailbox
    provisioning, and chat messages.

    Payloads carry a compact summary (counts and resource ids), never
    row-level data. Fetch the full Job with
    `GET /api/v3/jobs/{job_id}`. Verify the `webhook-signature` header
    on every request; receivers MUST dedupe on `webhook-id`. Subscribe
    to specific types or the `job.*` wildcard in
    **Settings → Developers → Webhooks**.
servers: []
security: []
paths: {}

````