Resume a failed task

curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "confirm": false
}
'

import requests

url = "https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume"

payload = { "confirm": False }
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({confirm: false})
};

fetch('https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume', 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://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume",
  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([
    'confirm' => false
  ]),
  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://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume"

	payload := strings.NewReader("{\n  \"confirm\": false\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://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"confirm\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume")

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  \"confirm\": false\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

{
  "error": "Bad request",
  "code": "user_spending_cap_reached",
  "error_id": "<string>",
  "kind": "forbidden request",
  "message": "<string>",
  "param": "<string>",
  "turnstile_site_key": "<string>"
}

{
  "error": "Bad request",
  "code": "user_spending_cap_reached",
  "error_id": "<string>",
  "kind": "forbidden request",
  "message": "<string>",
  "param": "<string>",
  "turnstile_site_key": "<string>"
}

{
  "error": "Bad request",
  "code": "user_spending_cap_reached",
  "error_id": "<string>",
  "kind": "forbidden request",
  "message": "<string>",
  "param": "<string>",
  "turnstile_site_key": "<string>"
}

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

Tasks

Resume a failed task

Rebuild a crashed or failed turn from its chunk log and continue it on the same stream, rather than starting the task over.

Refuses rather than guesses. A turn the user cancelled deliberately, a BYOK run whose credentials only ever arrived on the original request, and a turn whose chunk log has expired are all declined with a reason. Deliberately stopped turns cannot be resumed, including with confirm: true. Send a new task message to request additional work instead.

Ownership is checked against the caller, not inferred from the task id.

POST

api

tasks

{id}

resume

Resume a failed task

curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "confirm": false
}
'

import requests

url = "https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume"

payload = { "confirm": False }
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({confirm: false})
};

fetch('https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume', 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://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume",
  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([
    'confirm' => false
  ]),
  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://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume"

	payload := strings.NewReader("{\n  \"confirm\": false\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://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"confirm\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/resume")

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  \"confirm\": false\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

{
  "error": "Bad request",
  "code": "user_spending_cap_reached",
  "error_id": "<string>",
  "kind": "forbidden request",
  "message": "<string>",
  "param": "<string>",
  "turnstile_site_key": "<string>"
}

{
  "error": "Bad request",
  "code": "user_spending_cap_reached",
  "error_id": "<string>",
  "kind": "forbidden request",
  "message": "<string>",
  "param": "<string>",
  "turnstile_site_key": "<string>"
}

{
  "error": "Bad request",
  "code": "user_spending_cap_reached",
  "error_id": "<string>",
  "kind": "forbidden request",
  "message": "<string>",
  "param": "<string>",
  "turnstile_site_key": "<string>"
}

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

{
  "success": true,
  "error": "<string>",
  "failure_cause": "<string>",
  "replayed": 123,
  "retryable": true,
  "state": "<string>",
  "stream_id": "<string>"
}

Authorizations

Authorization

string

header

required

JWT authentication token

Path Parameters

string<uuid>

required

Task ID

Body

application/json

confirm

boolean

default:false

deprecated

Retained for compatibility and ignored. Deliberately stopped turns cannot be resumed, regardless of this value.

Response

Resume accepted; the turn continues on the same stream

success

boolean

required

error

string

Present on every refusal, and always says which gate declined.

failure_cause

string

Why the turn originally ended, when the row recorded one.

replayed

integer

Chunks replayed out of the trusted prefix.

retryable

boolean

True only when no replay started and the same recovery may be attempted again.

state

string

Integrity verdict for the rebuilt history.

stream_id

string

The stream the turn continues on — the same one it crashed on.