jobs

Answer a job's question

Answer every question in a job's input request at once; the job then continues.

Secrets and website logins sent here pass through your client. To keep them private, give the person the input request's answer_url instead. Sending the same answers again counts as one answer.

post/v1/jobs/{id}/answers

Request

  • Base URL: https://api.pomerado.ai
  • URL: https://api.pomerado.ai/v1/jobs/{id}/answers
  • Auth: HTTP bearer

Path parameters

idstring required
Example:job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190

a job ID: job_ and 32 lowercase hex digits

Query parameters

include_result'true' | 'false'

false to read the job without its result, which stays for a later read; result_status says whether one waits. Default true.

Request body

input_request_idstring required

The input_request.id you are answering

answersobject required

Answers keyed by question ID. choice: an option ID, {"other": text} (allow_other) or {"option": id, "note": text} (allow_note). multi_choice: option IDs, or {"options": [ids]} with "other" (allow_other) and "note" (allow_note). text and secret: a string. confirm: {"confirmed": true|false}. login: {"username", "password", "save_login"}, where username is the identifier its fields name (username, email, phone or account_number), left out when they name none, and password is sent only when fields lists it. A login whose fields name several identifiers is answered at its answer_url.

Example request

{
  "input_request_id": "req_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
}

Response

The job, continuing

idstring required

a job ID: job_ and 32 lowercase hex digits

type'run' | 'build' required
status'queued' | 'running' | 'needs_input' | 'succeeded' | 'failed' | 'cancelled' required
tool_idstring nullable required
resultunknown required
result_previewunknown
result_status'available' | 'delivered' | 'expired' nullable required
result_expires_atstring required

a string to be decoded into a Date

write_status'not_attempted' | 'may_have_applied' | 'applied' | 'not_applied' nullable required
messagestring nullable required
site_urlstring nullable

The website's https origin the job was asked for: a build's site_url, or the site of the tool a run runs

site_namestring nullable

The site's name: its tool's integration's, else the integration of its website; null until one names it

taskstring nullable

A build's task, or a requested change, as it was sent; null for a run and a job accepted before Pomerado kept tasks

tool_namestring nullable

The name of the tool tool_id names, as GET /v1/tools shows it

waiting_sincestring nullable

When the question input_request asks was asked; null when the job asks none

watch_urlstring required
tipstring
created_atstring required

a string to be decoded into a Date

updated_atstring required

a string to be decoded into a Date

completed_atstring required

a string to be decoded into a Date

Example response

{
  "id": "job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
  "input_request": {
    "id": "req_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
  },
  "build": {
    "integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.