List human review tasks assigned to the current user

curl --request GET \
  --url https://flows.super.ai/api/human-review-tasks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flows.super.ai/api/human-review-tasks', 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://flows.super.ai/api/human-review-tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://flows.super.ai/api/human-review-tasks"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flows.super.ai/api/human-review-tasks")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "items": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "flow_execution_id": "550e8400-e29b-41d4-a716-446655440000",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "modified_by": "<string>",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "source_task_execution_idx": 0,
      "source_task_name": "process_document",
      "status": "pending",
      "target_task_executions": [
        {
          "task_execution_idx": 0,
          "task_name": "extract_doc",
          "is_editable": true,
          "output_collection_idx": 0,
          "output_name": "rows"
        }
      ],
      "updated_at": "2023-11-07T05:31:56Z",
      "completed_at": "2024-01-01T00:00:00Z",
      "completed_by": "550e8400-e29b-41d4-a716-446655440000",
      "human_messages": [
        "Please verify the total amount",
        "Check the invoice date"
      ],
      "instructions": "Please review the document and verify all dates are correct.",
      "review_annotations": [
        {
          "message": "Each line item needs a SKU",
          "output_name": "line_items",
          "path": [
            2,
            "sku"
          ],
          "source_task_execution_idx": 2,
          "source_task_name": "validate_rows",
          "task_execution_idx": 0,
          "task_name": "extract_doc"
        }
      ],
      "review_result": true,
      "reviewed_output": [
        {
          "comments": "All dates are correct.",
          "verified": true
        }
      ],
      "signal_sent": true,
      "task_metadata": {
        "priority": "high",
        "source": "api"
      }
    }
  ],
  "limit": 10,
  "offset": 0,
  "total_count": 42
}

human-review-tasks

List human review tasks assigned to the current user

List all human review tasks assigned to the current user.

Returns a paginated list of human review tasks that have been assigned to the currently authenticated user. Tasks are joined with assignments to filter by user.

Context:

Returns only tasks assigned to the current user
Excludes soft-deleted tasks
Results are paginated using offset and limit
Tasks can be filtered by one or more statuses (optional, comma-separated)
Tasks can be filtered by source task name (optional)
Tasks can be filtered by flow execution ID (optional)
Tasks can be filtered by flow ID stored in task_metadata (optional)
Tasks can be filtered by tags, connected by tags_mode — ANY of them (default) or ALL of them, matched at run level so the tags may sit on different tasks (optional)
Tasks can be excluded by tags via tags_exclude, which drops a run when any of its tasks carries one of those tags (optional)
Tasks can be filtered by metadata key-value pairs (optional, AND between groups, OR within)
Tasks can be sorted by created_at, updated_at, source_task_title or run_created_at (optional). source_task_title groups items sharing a Source Task Name; within each group items are ordered oldest-first by created_at regardless of sort_direction. run_created_at orders by the run’s creation date, which a re-run leaves untouched.

Use Cases:

Display user’s assigned review tasks in a dashboard
Show pending reviews for the current user
Filter tasks by status (e.g., only show pending tasks)
Filter tasks by multiple statuses (e.g., ‘pending,in_progress’)
Filter tasks by source task name or flow execution
Filter tasks by tags or metadata for targeted task discovery
Narrow to runs carrying every one of several tags (tags_mode=all), or drop runs carrying an unwanted tag (tags_exclude)
Sort tasks by creation or update time
Track review task assignments

Related Endpoints:

POST /human-review-tasks - Create a new review task
GET /human-review-tasks/ - Get specific task details

GET

api

human-review-tasks

List human review tasks assigned to the current user

curl --request GET \
  --url https://flows.super.ai/api/human-review-tasks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flows.super.ai/api/human-review-tasks', 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://flows.super.ai/api/human-review-tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://flows.super.ai/api/human-review-tasks"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flows.super.ai/api/human-review-tasks")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "items": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "flow_execution_id": "550e8400-e29b-41d4-a716-446655440000",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "modified_by": "<string>",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "source_task_execution_idx": 0,
      "source_task_name": "process_document",
      "status": "pending",
      "target_task_executions": [
        {
          "task_execution_idx": 0,
          "task_name": "extract_doc",
          "is_editable": true,
          "output_collection_idx": 0,
          "output_name": "rows"
        }
      ],
      "updated_at": "2023-11-07T05:31:56Z",
      "completed_at": "2024-01-01T00:00:00Z",
      "completed_by": "550e8400-e29b-41d4-a716-446655440000",
      "human_messages": [
        "Please verify the total amount",
        "Check the invoice date"
      ],
      "instructions": "Please review the document and verify all dates are correct.",
      "review_annotations": [
        {
          "message": "Each line item needs a SKU",
          "output_name": "line_items",
          "path": [
            2,
            "sku"
          ],
          "source_task_execution_idx": 2,
          "source_task_name": "validate_rows",
          "task_execution_idx": 0,
          "task_name": "extract_doc"
        }
      ],
      "review_result": true,
      "reviewed_output": [
        {
          "comments": "All dates are correct.",
          "verified": true
        }
      ],
      "signal_sent": true,
      "task_metadata": {
        "priority": "high",
        "source": "api"
      }
    }
  ],
  "limit": 10,
  "offset": 0,
  "total_count": 42
}

Authorizations

Authorization

string

header

required

JWT Bearer token authentication. Include your access token in the Authorization header as: Bearer YOUR_ACCESS_TOKEN

Example:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Query Parameters

offset

integer

default:0

Number of records to skip for pagination

Required range: x >= 0

limit

integer

default:100

Maximum number of records to return

Required range: 1 <= x <= 1000

status

string | null

Filter tasks by status(es). Valid values: 'pending', 'in_progress', 'completed'. Multiple statuses can be provided as comma-separated values (e.g., 'pending,in_progress').

source_task_name

string | null

Filter tasks by source task name

flow_execution_id

string<uuid> | null

Filter tasks by flow execution ID

flow_id

string<uuid> | null

Filter tasks by flow ID (stored in task_metadata)

Response

Paginated list of human review tasks retrieved successfully

Paginated response wrapping a page of human review tasks with total count.

items

HumanReviewTaskResponse · object[]

required

Human review tasks for the requested page.

Show child attributes

limit

integer

required

Limit applied to this page.

Example:

10

offset

integer

required

Offset applied to this page.

Example:

0

total_count

integer

required

Total number of tasks matching the filters (ignoring offset/limit).

Example:

42