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>' \
  --header 'X-API-Key: <api-key>'

import requests

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

headers = {
    "X-API-Key": "<api-key>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-API-Key': '<api-key>', 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>",
    "X-API-Key: <api-key>"
  ],
]);

$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("X-API-Key", "<api-key>")
	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://flows.super.ai/api/human-review-tasks")
  .header("X-API-Key", "<api-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

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["X-API-Key"] = '<api-key>'
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "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_execution_idx": 0,
    "target_task_name": "receive_file",
    "updated_at": "2023-11-07T05:31:56Z",
    "completed_at": "2024-01-01T00:00:00Z",
    "completed_by": "550e8400-e29b-41d4-a716-446655440000",
    "instructions": "Please review the document and verify all dates are correct.",
    "review_result": true,
    "reviewed_output": {
      "comments": "All dates are correct.",
      "verified": true
    },
    "task_metadata": {
      "priority": "high",
      "source": "api"
    }
  }
]

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 target task name (optional)
Tasks can be filtered by source task name (optional)
Tasks can be filtered by flow execution ID (optional)
Tasks are returned in the order they appear in the database

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 specific target task name, source task name, or flow execution
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>' \
  --header 'X-API-Key: <api-key>'

import requests

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

headers = {
    "X-API-Key": "<api-key>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-API-Key': '<api-key>', 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>",
    "X-API-Key: <api-key>"
  ],
]);

$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("X-API-Key", "<api-key>")
	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://flows.super.ai/api/human-review-tasks")
  .header("X-API-Key", "<api-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

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["X-API-Key"] = '<api-key>'
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "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_execution_idx": 0,
    "target_task_name": "receive_file",
    "updated_at": "2023-11-07T05:31:56Z",
    "completed_at": "2024-01-01T00:00:00Z",
    "completed_by": "550e8400-e29b-41d4-a716-446655440000",
    "instructions": "Please review the document and verify all dates are correct.",
    "review_result": true,
    "reviewed_output": {
      "comments": "All dates are correct.",
      "verified": true
    },
    "task_metadata": {
      "priority": "high",
      "source": "api"
    }
  }
]

Authorizations

X-API-Key

string

header

required

API key authentication. Include your API key in the X-API-Key header as: X-API-Key YOUR_API_KEY

Example:

X-API-Key: saf_1234567890

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').

target_task_name

string | null

Filter tasks by target task name

source_task_name

string | null

Filter tasks by source task name

flow_execution_id

string<uuid> | null

Filter tasks by flow execution ID

Response

List of human review tasks retrieved successfully

created_at

string<date-time>

required

flow_execution_id

string<uuid>

required

UUID of the flow execution this task is associated with.

Example:

"550e8400-e29b-41d4-a716-446655440000"

string<uuid>

required

modified_by

string

required

organization_id

string<uuid>

required

UUID of the organization this task belongs to.

Example:

"550e8400-e29b-41d4-a716-446655440000"

source_task_execution_idx

integer

required

Index of the source task execution that created this review.

Example:

0

source_task_name

string

required

Name of the source task that created this review.

Example:

"process_document"

status

string

required

Status of the task. Valid values: 'pending', 'in_progress', 'completed'.

Example:

"pending"

target_task_execution_idx

integer

required

Index of the target task execution.

Example:

0

target_task_name

string

required

Name of the target task being reviewed.

Example:

"receive_file"

updated_at

string<date-time>

required

completed_at

string<date-time> | null

Timestamp when the task was completed. Null for not completed tasks.

Example:

"2024-01-01T00:00:00Z"

completed_by

string<uuid> | null

UUID of the user who completed this task. Null for not completed tasks.

Example:

"550e8400-e29b-41d4-a716-446655440000"

instructions

string | null

Instructions for the human reviewer on how to complete this task.

Example:

"Please review the document and verify all dates are correct."

review_result

boolean | null

Review result: True for correct, False for incorrect, null for not yet finished.

Example:

true

reviewed_output

Reviewed Output · object | null

JSON output of the completed review. Null for not yet completed tasks.

Example:

{
  "comments": "All dates are correct.",
  "verified": true
}

task_metadata

Task Metadata · object | null

Additional metadata associated with the human review task.

Example:

{ "priority": "high", "source": "api" }

List task summaries for flow version Create a new human review task