Resolve a waiting task run

curl --request POST \
  --url https://api.crevio.co/v1/task_runs/{id}/resolve \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approvals": [
    {
      "id": "<string>",
      "approved": true,
      "reason": "<string>"
    }
  ],
  "message": "<string>"
}
'

import requests

url = "https://api.crevio.co/v1/task_runs/{id}/resolve"

payload = {
    "approvals": [
        {
            "id": "<string>",
            "approved": True,
            "reason": "<string>"
        }
    ],
    "message": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    approvals: [{id: '<string>', approved: true, reason: '<string>'}],
    message: '<string>'
  })
};

fetch('https://api.crevio.co/v1/task_runs/{id}/resolve', 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://api.crevio.co/v1/task_runs/{id}/resolve",
  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([
    'approvals' => [
        [
                'id' => '<string>',
                'approved' => true,
                'reason' => '<string>'
        ]
    ],
    'message' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "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://api.crevio.co/v1/task_runs/{id}/resolve"

	payload := strings.NewReader("{\n  \"approvals\": [\n    {\n      \"id\": \"<string>\",\n      \"approved\": true,\n      \"reason\": \"<string>\"\n    }\n  ],\n  \"message\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "<api-key>")
	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://api.crevio.co/v1/task_runs/{id}/resolve")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"approvals\": [\n    {\n      \"id\": \"<string>\",\n      \"approved\": true,\n      \"reason\": \"<string>\"\n    }\n  ],\n  \"message\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.crevio.co/v1/task_runs/{id}/resolve")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"approvals\": [\n    {\n      \"id\": \"<string>\",\n      \"approved\": true,\n      \"reason\": \"<string>\"\n    }\n  ],\n  \"message\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "object": "<string>",
  "task_id": "<string>",
  "task_name": "<string>",
  "chat_id": "<string>",
  "cancel_requested_at": "<string>",
  "status": "pending",
  "summary": "<string>",
  "error_message": "<string>",
  "test_run": true,
  "input_tokens": 123,
  "output_tokens": 123,
  "credits_consumed": 123,
  "tool_calls_count": 123,
  "duration_ms": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "skip_reason": "condition",
  "skip_count": 123,
  "delivery_status": "delivered",
  "completion": "verified",
  "trigger_source": "scheduled",
  "trigger_event": {},
  "replay_of": "<string>",
  "captured_deliveries": "<array>",
  "pending_approval_ids": "<array>"
}

{
  "id": "<string>",
  "object": "<string>",
  "task_id": "<string>",
  "task_name": "<string>",
  "chat_id": "<string>",
  "cancel_requested_at": "<string>",
  "status": "pending",
  "summary": "<string>",
  "error_message": "<string>",
  "test_run": true,
  "input_tokens": 123,
  "output_tokens": 123,
  "credits_consumed": 123,
  "tool_calls_count": 123,
  "duration_ms": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "skip_reason": "condition",
  "skip_count": 123,
  "delivery_status": "delivered",
  "completion": "verified",
  "trigger_source": "scheduled",
  "trigger_event": {},
  "replay_of": "<string>",
  "captured_deliveries": "<array>",
  "pending_approval_ids": "<array>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "bad_request",
    "message": "The request was malformed or contained invalid parameters"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "authentication_required",
    "message": "You did not provide an API key."
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "forbidden",
    "message": "You do not have permission to perform this action"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_missing",
    "message": "The requested resource was not found"
  }
}

{
  "error": {
    "type": "api_error",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>",
    "errors": {},
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "validation_error",
    "code": "validation_failed",
    "message": "Email is required",
    "errors": {
      "email": [
        "can't be blank"
      ]
    }
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry later."
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "An unexpected error occurred"
  }
}

Task runs

Resolve a waiting task run

Typed resolution for a run paused in needs_input. type: "approvals" answers the run’s pending integration approvals — the submitted set must exactly match pending_approval_ids on the run, or the request returns 409 stale_resolution (re-read the run and retry). type: "input" sends follow-up instructions into the run’s chat and starts a new turn. type: "complete" closes the run as completed without resuming it. Returns 202 when the run resumes in the background (approvals, input) and 200 when resolved inline (complete). 409 run_not_waiting if the run is not in needs_input.

POST

task_runs

{id}

resolve

Resolve a waiting task run

curl --request POST \
  --url https://api.crevio.co/v1/task_runs/{id}/resolve \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approvals": [
    {
      "id": "<string>",
      "approved": true,
      "reason": "<string>"
    }
  ],
  "message": "<string>"
}
'

import requests

url = "https://api.crevio.co/v1/task_runs/{id}/resolve"

payload = {
    "approvals": [
        {
            "id": "<string>",
            "approved": True,
            "reason": "<string>"
        }
    ],
    "message": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    approvals: [{id: '<string>', approved: true, reason: '<string>'}],
    message: '<string>'
  })
};

fetch('https://api.crevio.co/v1/task_runs/{id}/resolve', 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://api.crevio.co/v1/task_runs/{id}/resolve",
  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([
    'approvals' => [
        [
                'id' => '<string>',
                'approved' => true,
                'reason' => '<string>'
        ]
    ],
    'message' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "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://api.crevio.co/v1/task_runs/{id}/resolve"

	payload := strings.NewReader("{\n  \"approvals\": [\n    {\n      \"id\": \"<string>\",\n      \"approved\": true,\n      \"reason\": \"<string>\"\n    }\n  ],\n  \"message\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "<api-key>")
	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://api.crevio.co/v1/task_runs/{id}/resolve")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"approvals\": [\n    {\n      \"id\": \"<string>\",\n      \"approved\": true,\n      \"reason\": \"<string>\"\n    }\n  ],\n  \"message\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.crevio.co/v1/task_runs/{id}/resolve")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"approvals\": [\n    {\n      \"id\": \"<string>\",\n      \"approved\": true,\n      \"reason\": \"<string>\"\n    }\n  ],\n  \"message\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "object": "<string>",
  "task_id": "<string>",
  "task_name": "<string>",
  "chat_id": "<string>",
  "cancel_requested_at": "<string>",
  "status": "pending",
  "summary": "<string>",
  "error_message": "<string>",
  "test_run": true,
  "input_tokens": 123,
  "output_tokens": 123,
  "credits_consumed": 123,
  "tool_calls_count": 123,
  "duration_ms": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "skip_reason": "condition",
  "skip_count": 123,
  "delivery_status": "delivered",
  "completion": "verified",
  "trigger_source": "scheduled",
  "trigger_event": {},
  "replay_of": "<string>",
  "captured_deliveries": "<array>",
  "pending_approval_ids": "<array>"
}

{
  "id": "<string>",
  "object": "<string>",
  "task_id": "<string>",
  "task_name": "<string>",
  "chat_id": "<string>",
  "cancel_requested_at": "<string>",
  "status": "pending",
  "summary": "<string>",
  "error_message": "<string>",
  "test_run": true,
  "input_tokens": 123,
  "output_tokens": 123,
  "credits_consumed": 123,
  "tool_calls_count": 123,
  "duration_ms": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "skip_reason": "condition",
  "skip_count": 123,
  "delivery_status": "delivered",
  "completion": "verified",
  "trigger_source": "scheduled",
  "trigger_event": {},
  "replay_of": "<string>",
  "captured_deliveries": "<array>",
  "pending_approval_ids": "<array>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "bad_request",
    "message": "The request was malformed or contained invalid parameters"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "authentication_required",
    "message": "You did not provide an API key."
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "forbidden",
    "message": "You do not have permission to perform this action"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_missing",
    "message": "The requested resource was not found"
  }
}

{
  "error": {
    "type": "api_error",
    "message": "<string>",
    "code": "<string>",
    "param": "<string>",
    "errors": {},
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "validation_error",
    "code": "validation_failed",
    "message": "Email is required",
    "errors": {
      "email": [
        "can't be blank"
      ]
    }
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry later."
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "An unexpected error occurred"
  }
}

Authorizations

Authorization

string

header

required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key

string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Path Parameters

string

required

Task run id (trun_...)

Body

application/json

type

enum<string>

required

Which resolution flow to run.

Available options:

approvals,

input,

complete

approvals

object[]

Required for type: "approvals". One decision per pending approval; must cover the exact pending set.

Show child attributes

message

string

Required for type: "input". Follow-up instructions for the agent.

Response

Resolved inline (type complete).

string

required

object

string

required

task_id

string

required

task_name

string

required

chat_id

string | null

required

The run's own conversation (aichat_...): what it read, called and said. Read it with search_chats.

cancel_requested_at

string | null

required

When a stop was requested. The run stays running until it reaches its next step, then settles as cancelled.

status

enum<string>

required

Available options:

pending,

running,

completed,

failed,

needs_input,

timed_out,

unknown,

skipped,

cancelled

summary

string | null

required

error_message

string | null

required

test_run

boolean

required

input_tokens

integer

required

output_tokens

integer

required

credits_consumed

integer

required

tool_calls_count

integer

required

duration_ms

integer | null

required

started_at

string<date-time> | null

required

completed_at

string<date-time> | null

required

created_at

string<date-time>

required

updated_at

string<date-time>

required

skip_reason

enum<string> | null

required

Available options:

condition,

no_paid_plan_or_credits,

no_recent_activity,

no_task_activity,

no_personal_sources,

wake_gate,

wake_limit,

rate_limited,

misfire,

task_busy,

account_at_capacity,

null

skip_count

integer

required

delivery_status

enum<string>

required

Available options:

delivered,

not_delivered,

not_requested,

unknown

completion

enum<string> | null

required

How the agent closed a completed run: verified (it re-checked the result), recorded (it reported without re-checking), or recovered (it never reported; summary is its last message). Null unless an agent turn completed the run.

Available options:

verified,

recorded,

recovered,

null

trigger_source

enum<string>

required

Available options:

scheduled,

event,

manual

trigger_event

object | null

required

The event that started this run, {type, data}, exactly as the run received it; data matches the event's webhook payload. Null for a run no event started. POST /task_runs/{id}/replay runs the task again on it.

replay_of

string | null

required

The run (trun_...) whose event this run replays. Null unless started by POST /task_runs/{id}/replay.

captured_deliveries

array

required

pending_approval_ids

array

required

Overview

Products & catalog

Selling & orders

Customers & leads

Marketing

Website & content

Scheduling & bookings

Calls & phone

AI & automation

Media library

Business & formation

Account & platform

Resolve a waiting task run

Authorizations

Headers

Path Parameters

Body

Response