Super.ai human-review-tasks API

openapi: 3.1.0
info:
  title: SuperAI Flow Platform auth human-review-tasks API
  description: "SuperAI Flows is a workflow orchestration platform that enables you to design, deploy, and monitor automated workflows at scale.\n\nBuild complex workflows using our declarative YAML DSL, execute them reliably, and integrate seamlessly with AI models, cloud storage, and enterprise systems.\n\n**Key Capabilities:**\n- **Workflow Management**: Define workflows as code with version control and automated execution\n- **Task Orchestration**: Chain together API calls, data processing, and AI operations\n- **Real-time Monitoring**: Track execution progress with WebSocket notifications and comprehensive logging\n- **Multi-tenant Architecture**: Organization-scoped resources with role-based access control\n\n**API Versioning and Breaking Changes:**\n\nWe follow a strict compatibility policy to ensure your integrations remain stable:\n\n- **Non-breaking changes** (safe, no action required):\n  - Adding new API endpoints\n  - Adding new optional query parameters to existing endpoints\n  - Adding new fields to API responses\n  - Adding new values to existing enums\n\n- **Breaking changes** (requires client updates):\n  - Removing or renaming API endpoints\n  - Removing query parameters or request fields\n  - Removing response fields\n  - Changing field types or validation rules\n  - Removing values from existing enums\n\n**Client Implementation Requirements:**\n\nYour API clients MUST be designed to gracefully handle additional fields in responses. We may add new fields to any response object without considering this a breaking change. Ensure your JSON parsers ignore unknown fields rather than raising errors.\n\n**Backward Compatibility Guarantee:**\n\nWe commit to maintaining backward compatibility for all non-breaking changes. Breaking changes will be:\n- Announced at least 15 days in advance\n- Documented in our changelog with migration guide\n\nFor the latest API updates and migration guides, see our changelog."
  version: 0.1.0
tags:
- name: human-review-tasks
  description: Human review task operations for creating and managing human-in-the-loop review workflows.
  x-displayName: Human Review Tasks
paths:
  /api/human-review-tasks:
    post:
      tags:
      - human-review-tasks
      summary: Create a new human review task
      description: "Create a new human review task with assigned users.\n\nCreates a new human review task and assigns it to the specified users.\nBoth the task and assignments are created in a single transaction.\n\nContext:\n    - The task is created with the provided flow and execution information\n    - All assigned users are linked to the task via assignments\n    - Organization ID is automatically set from the current user's context\n\nUse Cases:\n    - Create a review task for a flow execution\n    - Assign multiple reviewers to a task\n    - Track human review workflow state\n\nRelated Endpoints:\n    - GET /human-review-tasks - List all tasks\n    - GET /human-review-tasks/{id} - Get task details"
      operationId: create_human_review_task_api_human_review_tasks_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HumanReviewTaskCreateRequest'
      responses:
        '201':
          description: Human review task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HumanReviewTaskResponse'
        '400':
          description: Bad Request - Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
    get:
      tags:
      - human-review-tasks
      summary: List human review tasks assigned to the current user
      description: "List all human review tasks assigned to the current user.\n\nReturns a paginated list of human review tasks that have been assigned to the\ncurrently authenticated user. Tasks are joined with assignments to filter by user.\n\nContext:\n    - Returns only tasks assigned to the current user\n    - Excludes soft-deleted tasks\n    - Results are paginated using offset and limit\n    - Tasks can be filtered by one or more statuses (optional, comma-separated)\n    - Tasks can be filtered by source task name (optional)\n    - Tasks can be filtered by flow execution ID (optional)\n    - Tasks can be filtered by flow ID stored in task_metadata (optional)\n    - Tasks can be filtered by tags with OR logic (optional)\n    - Tasks can be filtered by metadata key-value pairs (optional, AND between groups, OR within)\n    - Tasks can be sorted by created_at or updated_at (optional)\n\nUse Cases:\n    - Display user's assigned review tasks in a dashboard\n    - Show pending reviews for the current user\n    - Filter tasks by status (e.g., only show pending tasks)\n    - Filter tasks by multiple statuses (e.g., 'pending,in_progress')\n    - Filter tasks by source task name or flow execution\n    - Filter tasks by tags or metadata for targeted task discovery\n    - Sort tasks by creation or update time\n    - Track review task assignments\n\nRelated Endpoints:\n    - POST /human-review-tasks - Create a new review task\n    - GET /human-review-tasks/{id} - Get specific task details"
      operationId: list_human_review_tasks_api_human_review_tasks_get
      parameters:
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Number of records to skip for pagination
          default: 0
          title: Offset
        description: Number of records to skip for pagination
        example: 0
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 1
          description: Maximum number of records to return
          default: 100
          title: Limit
        description: Maximum number of records to return
        example: 100
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: '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'').'
          title: Status
        description: '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'').'
        example: pending
      - name: source_task_name
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter tasks by source task name
          title: Source Task Name
        description: Filter tasks by source task name
        example: my_source_task
      - name: flow_execution_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          description: Filter tasks by flow execution ID
          title: Flow Execution Id
        description: Filter tasks by flow execution ID
        example: 123e4567-e89b-12d3-a456-426614174000
      - name: flow_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          description: Filter tasks by flow ID (stored in task_metadata)
          title: Flow Id
        description: Filter tasks by flow ID (stored in task_metadata)
      - name: tags
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Filter tasks by tags (OR logic). Repeated query param, e.g. ?tags=a&tags=b
          title: Tags
        description: Filter tasks by tags (OR logic). Repeated query param, e.g. ?tags=a&tags=b
      - name: metadata
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: JSON-encoded list of MetadataFilterGroup objects for metadata filtering. Each group has a 'key' and 'values' (OR within group, AND between groups).
          title: Metadata
        description: JSON-encoded list of MetadataFilterGroup objects for metadata filtering. Each group has a 'key' and 'values' (OR within group, AND between groups).
      - name: sort_field
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - created_at
            - updated_at
            type: string
          - type: 'null'
          description: Field to sort results by
          title: Sort Field
        description: Field to sort results by
      - name: sort_direction
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - asc
            - desc
            type: string
          - type: 'null'
          description: Sort direction
          title: Sort Direction
        description: Sort direction
      responses:
        '200':
          description: Paginated list of human review tasks retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedHumanReviewTasksResponse'
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
  /api/human-review-tasks/{task_id}/start:
    post:
      tags:
      - human-review-tasks
      summary: Start a human review task
      description: "Start a human review task.\n\nMarks the task as in progress for the current user. This endpoint:\n- Creates an in-progress record linking the user to the task\n- Changes task status from 'pending' to 'in_progress' (if it's pending)\n- Returns 409 if the task is already completed\n- Can be called multiple times for the same user (idempotent)\n- Creates a timeout schedule to automatically unstart the task if it remains IN_PROGRESS beyond the configured timeout\n\nContext:\n    - Only authenticated users can start tasks\n    - Updates assignment status to 'in_progress' and sets started_at timestamp\n    - Updates task status if currently pending\n    - Organization ID is automatically set from the current user's context\n\nUse Cases:\n    - User begins working on an assigned review task\n    - Track which users are currently working on which tasks\n    - Prevent starting already completed tasks\n\nRelated Endpoints:\n    - GET /human-review-tasks - List all assigned tasks\n    - POST /human-review-tasks - Create a new review task"
      operationId: start_human_review_task_api_human_review_tasks__task_id__start_post
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          title: Task Id
      responses:
        '200':
          description: Human review task started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HumanReviewTaskResponse'
        '404':
          description: Human review task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict - Task is already completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
  /api/human-review-tasks/{task_id}/complete:
    post:
      tags:
      - human-review-tasks
      summary: Complete a human review task
      description: "Complete a human review task with validated output.\n\nMarks the task as completed and records the review results. This endpoint:\n- Validates reviewed_output against target task's output model\n- Updates task status to 'completed'\n- Records the review result (correct/incorrect) and reviewed output\n- Sets completed_by and completed_at fields\n- Removes the in-progress record for the user\n- Returns 404 if task not found\n- Returns 400 if task status is not 'in_progress' or validation fails\n\nContext:\n    - Only authenticated users can complete tasks\n    - Task must be in 'in_progress' status\n    - Records who completed the task and when\n    - Automatically removes in-progress tracking\n    - Output is validated against the target task's schema\n\nUse Cases:\n    - User finishes reviewing a task and submits their results\n    - Record validation outcomes for data quality tracking\n    - Complete workflow steps requiring human judgment\n\nRelated Endpoints:\n    - POST /human-review-tasks/{task_id}/start - Start working on a task\n    - GET /human-review-tasks - List all assigned tasks"
      operationId: complete_human_review_task_api_human_review_tasks__task_id__complete_post
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          title: Task Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HumanReviewTaskCompleteRequest'
      responses:
        '200':
          description: Human review task completed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HumanReviewTaskResponse'
        '400':
          description: Bad Request - Task status invalid or output validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Human review task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
  /api/human-review-tasks/{task_id}/unstart:
    post:
      tags:
      - human-review-tasks
      summary: Unstart a human review task assignment
      description: "Unstart a human review task assignment.\n\nResets an in_progress assignment back to pending status. This allows users\nto temporarily leave the review page and potentially return later to continue\ntheir review.\n\nOnly valid for assignments with status 'in_progress'. Attempting to unstart\nan assignment with any other status will result in a 409 Conflict error.\n\nContext:\n    - Only authenticated users can unstart their assignments\n    - Only affects assignments with status 'in_progress'\n    - Resets assignment status back to 'pending' (opposite of /start)\n    - Task status remains unchanged\n    - Organization ID is automatically set from the current user's context\n\nUse Cases:\n    - User needs to temporarily leave the review page\n    - User wants to pause their review and continue later\n    - Browser/page navigation that should save progress but not complete\n\nRelated Endpoints:\n    - POST /human-review-tasks/{task_id}/start - Start working on a task\n    - POST /human-review-tasks/{task_id}/complete - Complete a task\n    - GET /human-review-tasks - List all assigned tasks"
      operationId: unstart_human_review_task_assignment_api_human_review_tasks__task_id__unstart_post
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          title: Task Id
      responses:
        '200':
          description: Human review task assignment unstarted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HumanReviewTaskResponse'
        '404':
          description: Human review task or assignment not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict - Assignment status is not 'in_progress'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
  /api/human-review-tasks/by-execution:
    get:
      tags:
      - human-review-tasks
      summary: List human review tasks for a flow execution (org-level access)
      description: 'List human review tasks for a flow execution without user-assignment filtering.


        Returns all non-deleted HITL tasks for the given flow execution, regardless of

        which user they are assigned to. Requires org membership (get_user_info).

        Intended for admin/observer use-cases such as viewing a completed HITL task.'
      operationId: list_human_review_tasks_by_execution_api_human_review_tasks_by_execution_get
      parameters:
      - name: flow_execution_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
          description: The flow execution ID to filter tasks by
          title: Flow Execution Id
        description: The flow execution ID to filter tasks by
      responses:
        '200':
          description: List of human review tasks retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HumanReviewTaskResponse'
                title: Response List Human Review Tasks By Execution Api Human Review Tasks By Execution Get
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
  /api/human-review-tasks/{task_id}:
    get:
      tags:
      - human-review-tasks
      summary: Get a human review task by ID
      description: "Get a human review task by its ID.\n\nReturns the details of a specific human review task, including its status,\ninstructions, review results, and completion information.\n\nContext:\n    - Returns the full task details for the specified task ID\n    - Excludes soft-deleted tasks\n    - Authorization is handled by RLS policies (user must have access to the organization)\n    - Returns 404 if the task does not exist\n\nUse Cases:\n    - View detailed information about a specific review task\n    - Display task details in a task management UI\n    - Check task status and review results\n    - Access task instructions and completion information\n\nRelated Endpoints:\n    - GET /human-review-tasks - List all tasks assigned to current user\n    - GET /human-review-tasks/{task_id}/assignments - List all assignments for a task\n    - POST /human-review-tasks/{task_id}/start - Start working on a task\n    - POST /human-review-tasks/{task_id}/complete - Complete a task"
      operationId: get_human_review_task_api_human_review_tasks__task_id__get
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          title: Task Id
      responses:
        '200':
          description: Human review task retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HumanReviewTaskResponse'
        '404':
          description: Human review task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Missing or invalid authentication credentials
          content:
            application/json:
              examples:
                missing_token:
                  summary: Missing authentication token
                  value:
                    error:
                      message: Authentication required
                      code: unauthorized
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                invalid_token:
                  summary: Invalid or expired token
                  value:
                    error:
                      message: Invalid authentication token
                      code: unauthorized
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error - An unexpected error occurred
          content:
            application/json:
              examples:
                internal_error:
                  summary: Internal server error
                  value:
                    error:
                      message: Internal server error
                      code: internal_error
                    request_id: 01K8KABR6S16YETA2SZPVBS9SP
                repository_error:
                  summary: Database error
                  value:
                    error:
                      message: Database operation failed
                      code: repository_error
                    request_id: 01K8KACP7D2XFGHJ9KLM4NPQR8
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - BearerAuth: []
      - APIKeyAuth: []
  /api

# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/superai/refs/heads/main/openapi/superai-human-review-tasks-api-openapi.yml