Arguments
| Argument | Required | Type | Description |
|---|---|---|---|
job_id | Yes | string | |
include_result | No | boolean | false to read the job without its result, which stays for a later read; result_status says whether one waits. Default true. |
input_request_id | No | string | The input_request.id you are answering |
answers | No | string | A JSON-encoded object with one answer per question id. choice: an option id, {“other”: text} when allow_other, or {“option”: id, “note”: text} when allow_note. multi_choice: an array of option ids, or {“options”: [ids]} with “other” and “note” when allowed. text and secret: a string. confirm: {“confirmed”: true or false}. login: {“username”, “password”, “save_login”}, with username holding the identifier its fields name (left out when they name none) and password only when fields lists it; answer a login whose fields name several identifiers at its answer_url. |
Output
The job, which continues, withnext, the call that follows it.
{
"job_id": "job_77777777777777777777777777777777",
"input_request_id": "req_99999999999999999999999999999999",
"answers": "{\"effect\":\"read\"}"
}
{
"id": "job_77777777777777777777777777777777",
"type": "build",
"status": "running",
"tool_id": null,
"input_request": null,
"result": null,
"result_status": null,
"result_expires_at": null,
"write_status": null,
"login_save": null,
"error": null,
"message": null,
"maintenance": null,
"build": {
"integration_id": null,
"stage": "exploring",
"stages": [
{
"key": "queued",
"label": "Queued",
"status": "done",
"started_at": "2026-10-09T17:00:00.000Z",
"completed_at": "2026-10-09T17:00:00.000Z"
},
{
"key": "exploring",
"label": "Exploring the site",
"status": "active",
"started_at": "2026-10-09T17:00:00.000Z",
"completed_at": null
},
{
"key": "building",
"label": "Building and testing",
"status": "pending",
"started_at": null,
"completed_at": null
},
{
"key": "publishing",
"label": "Reviewing and publishing",
"status": "pending",
"started_at": null,
"completed_at": null
}
],
"eta": { "min_seconds": 420, "max_seconds": 900 },
"example_result": null,
"existing_tool_id": null
},
"watch_url": "https://app.pomerado.ai/integrations/new?job=job_77777777777777777777777777777777",
"created_at": "2026-10-09T17:00:00.000Z",
"updated_at": "2026-10-09T17:00:00.000Z",
"completed_at": null,
"next": {
"action": "wait",
"call": {
"tool": "get_job",
"arguments": {
"job_id": "job_77777777777777777777777777777777",
"wait_seconds": 1800
}
},
"why": "This job may stop to ask a question. A question expires 10 minutes after it is asked and fails the job if nobody answers. The call returns as soon as the job asks or finishes; while the job still runs, call it again.",
"if_your_tool_calls_time_out_sooner": "Pass a wait_seconds below your client's tool-call timeout and repeat the call until the job is not running."
}
}
Details
Details
- Pass input_request_id and answers keyed by question id.
- Logins and secrets belong on the input_request’s answer_url, which keeps them out of this conversation. Answer one here only if the user agrees.
- With job_id alone, it returns the job and its answer_url.
- Never send TOTP seeds or durable tokens.