POST
/
v1
/
agent-tasks
/
{task_id}
/
input
Answer a task
curl --request POST \
  --url https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Use the second option, and keep the tone warm.",
  "question_id": "6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18"
}
'
import requests

url = "https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input"

payload = {
"text": "Use the second option, and keep the tone warm.",
"question_id": "6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
text: 'Use the second option, and keep the tone warm.',
question_id: '6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18'
})
};

fetch('https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'text' => 'Use the second option, and keep the tone warm.',
'question_id' => '6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input"

payload := strings.NewReader("{\n \"text\": \"Use the second option, and keep the tone warm.\",\n \"question_id\": \"6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"text\": \"Use the second option, and keep the tone warm.\",\n \"question_id\": \"6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://platform.jobbit.uk/v1/agent-tasks/{task_id}/input")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"text\": \"Use the second option, and keep the tone warm.\",\n \"question_id\": \"6f1c0a52-9d3e-4a87-b214-7e5a0c3d9b18\"\n}"

response = http.request(request)
puts response.read_body
{
  "task_id": "c41d7e0a-5b92-4f63-8e1a-3a9d2f6b7c10",
  "status": "running",
  "reason": null,
  "goal_completed": null,
  "output": null,
  "text": null,
  "artifacts": [],
  "files": [],
  "error": null,
  "metrics": {
    "cost_credits": null,
    "cost_usd": null,
    "turns": null,
    "duration_seconds": null
  },
  "chat_id": "9a2f6d1e-83c4-4b05-a7e9-0c5d1b4f2e68",
  "workspace": "kent-physio-site",
  "model": "jobbit/pro",
  "effort": "high",
  "on_question": "fail",
  "question": null,
  "questions_asked": 0,
  "budget_credits": 200,
  "source": {
    "ticket": "KP-142"
  },
  "created_at": "2026-11-05T14:02:11+00:00",
  "started_at": null,
  "finished_at": null
}
{
"error": {
"code": "invalid_key",
"message": "the API key is missing or invalid",
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}
{
"error": {
"code": "insufficient_scope",
"message": "this key does not have the deploy:write permission",
"details": {
"required": "deploy:write"
},
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}
{
"error": {
"code": "task_not_found",
"message": "task not found",
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}
{
"error": {
"code": "not_waiting",
"message": "the task is not waiting for an answer",
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}
{
"error": {
"code": "answer_too_large",
"message": "the answer is longer than 8000 characters",
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}
{
"error": {
"code": "empty_answer",
"message": "answer with text, files or both",
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}
{
"error": {
"code": "rate_limited",
"message": "too many read requests, retry in 4 s",
"details": {
"group": "read",
"limit": 120,
"window_seconds": 60
},
"request_id": "5d3f0b7c8a2e4e19b6c47a90d1e2f3a4"
}
}

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer jb_live_…

Path Parameters

task_id
string
required

The task id.

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9-]+$

Body

application/json
text
string
default:""

Your answer in words. Send text, files or both.

Maximum string length: 8000
files
string[]

Ids of files from POST /v1/files to answer with, up to 20. The key also needs files:read.

Maximum array length: 20
Required string length: 1 - 64
question_id
string

The question.id you are answering. If the task has moved on to another question, the answer is refused.

Maximum string length: 64

Response

The task, back in the queue.

task_id
string
required

The task id.

status
enum<string>
required

Where the task is.

Available options:
queued,
running,
waiting_input,
succeeded,
failed,
cancelled
reason
string | null

Why the task is in this state: completed, cancelled, question, invalid_output, budget_exceeded, timed_out, goal_unreachable, worker_stopped, insufficient_credits or run_failed.

goal_completed
boolean | null

Whether the agent reports that the goal was met.

output
any

The result following your output_schema. Only set when the task succeeded and a schema was given.

text
string | null

The agent's final answer as text.

artifacts
object[]

Files the agent made.

files
string[]

Ids of the files handed to the task.

error
string | null

What went wrong, for a failed task.

metrics
object
chat_id
string | null

The id of the chat in the Jobbit app where the work happens.

workspace
string | null

The workspace key, if one was given.

model
string

The model the task runs on.

effort
string

The effort level.

on_question
enum<string>

Whether the task may ask questions.

Available options:
fail,
ask
question
object | null

The open question, while the status is waiting_input.

questions_asked
integer

How many questions the task has asked.

budget_credits
number

The most credits the task may spend.

source
object

Your source labels.

created_at
string<date-time>

When the task was created.

started_at
string<date-time> | null

When it started running.

finished_at
string<date-time> | null

When it finished.