Refuel Tasks API

The Tasks API from Refuel — 28 operation(s) for tasks.

Operations 42

GET /tasks Get Team Tasks #
GET /tasks/{task_id} Get Task #
POST /tasks/{task_id} Edit Task #
DELETE /tasks/{task_id} Delete Task #
GET /tasks/{task_id}/models Get Task Models #
DELETE /tasks/{task_id}/subtasks/{subtask_id} Delete Subtask #
DELETE /tasks/{task_id}/transforms/{transform_id} Delete Transform #
GET /tasks/{task_id}/datasets/{dataset_id} Get Items From Task Run #
GET /tasks/{task_id}/seedset Get Items From Seedset #
GET /tasks/{task_id}/evalset Get Items From Evalset #
POST /tasks/{task_id}/evalset Create Evalset #
GET /tasks/{task_id}/runs/{dataset_id}/metrics Get Metrics For Task Run #
GET /tasks/{task_id}/evalset/metrics Get Evalset Metrics For Task Run #
GET /tasks/{task_id}/runs/{dataset_id} Get Task Run #
POST /tasks/{task_id}/runs/{dataset_id} Update Task Run #
DELETE /tasks/{task_id}/runs/{dataset_id} Clear Task Run #
GET /tasks/{task_id}/runs Get Task Runs #
POST /tasks/{task_id}/runs Update Task Run V2 #
GET /tasks/{task_id}/datasets/{dataset_id}/items/{item_id}/label Preview Labels V2 #
POST /tasks/{task_id}/datasets/{dataset_id}/items/{item_id}/label Edit Labels V2 #
DELETE /tasks/{task_id}/evalset/items/{item_id} Remove Item From Evalset #
POST /tasks/{task_id}/evalset/items Add Item To Evalset #
DELETE /tasks/{task_id}/seedset/items/{item_id} Remove Item From Seedset #
POST /tasks/{task_id}/seedset/items Add Item To Seedset #
GET /tasks/{task_id}/datasets/{dataset_id}/items/{item_id} Get Item From Task Run #
POST /tasks/{task_id}/datasets/{dataset_id}/items/{item_id} Modify Item Properties #
GET /tasks/{task_id}/evalset/runs Get Evalset Run #
POST /tasks/{task_id}/evalset/runs Update Task Run Evalset #
POST /tasks/{task_id}/{tag}/exports Export Task #
GET /tasks/{task_id}/{tag}/exports/{export_id} Download Export Task #
GET /tasks/{task_id}/taxonomies/{taxonomy_id} Get Taxonomy #
POST /tasks/{task_id}/taxonomies/{taxonomy_id} Add Labels To Taxonomy With File #
DELETE /tasks/{task_id}/taxonomies/{taxonomy_id} Delete Taxonomy #
POST /tasks/{task_id}/taxonomies Create Taxonomy With Labels File #
DELETE /tasks/{task_id}/taxonomies/{taxonomy_id}/labels/{label_id} Delete Subtask Label #
PATCH /tasks/{task_id}/taxonomies/{taxonomy_id}/labels/{label_id} Edit Taxonomy Label #
POST /tasks/{task_id}/taxonomies/{taxonomy_id}/duplicate Duplicate Taxonomy #
GET /tasks/{task_id}/calibrations Get Calibration Models #
POST /tasks/{task_id}/calibrations Calibrate Task #
GET /tasks/{task_id}/calibrations/{calibration_id} Get Calibration Model From Id #
PATCH /tasks/{task_id}/calibrations/{calibration_id} Update Calibration Model #
GET /tasks/{task_id}/trainable Trainable Task #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/refuel-ai-tasks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

refuel-ai-tasks-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Refuel Cloud Tasks API
  description: REST API for the Refuel Cloud data-labeling and data-enrichment platform. Harvested verbatim from https://cloud-api.refuel.ai/openapi.json (FastAPI-generated, OpenAPI 3.1.0). Covers projects, datasets, tasks, task runs, taxonomies, seedsets/evalsets, calibration, finetuned models, deployed applications and their realtime label endpoint, users, teams, usage, and integrations. Authentication is an API key sent as an HTTP Bearer token. The upstream document carries the FastAPI default info block (title "FastAPI", version 0.1.0) and no servers[]; API Evangelist supplies the title/description and the servers[] host documented in Refuel's own quickstart and catalog pages. See openapi/_original/ for the untouched document and overlays/ for every change.
  version: 0.1.0
  contact:
    name: Refuel
    url: https://www.refuel.ai
    email: support@refuel.ai
  termsOfService: https://www.refuel.ai/terms-of-service
  x-harvested-from: https://cloud-api.refuel.ai/openapi.json
  x-harvested-on: '2026-08-14'
servers:
- url: https://cloud-api.refuel.ai
  description: Refuel Cloud API
tags:
- name: Tasks
paths:
  /tasks:
    get:
      summary: Get Team Tasks
      description: "Get all tasks for a team.\n\nArgs:\n----\n    token: Authentication token containing team info\n\nReturns:\n-------\n    ResponseModel: List of tasks for the team"
      operationId: get_team_tasks_tasks_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel_List_'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}:
    get:
      summary: Get Task
      description: "Get details for a specific task.\n\nArgs:\n----\n    task_id: ID of the task to retrieve\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing the task details\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: get_task_tasks__task_id__get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    post:
      summary: Edit Task
      description: "Edit properties of an existing task.\n\nArgs:\n----\n    task_id: ID of the task to edit\n    edits: Dictionary of edits to apply to the task\n    clear_labels_and_feedback: Whether to clear existing labels and feedback\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing the updated task details\n\nRaises:\n------\n    HTTPException: If task not found, unauthorized, or edits are invalid"
      operationId: edit_task_tasks__task_id__post
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: false
        schema:
          type: boolean
          title: Clear Labels And Feedback
          default: false
        name: clear_labels_and_feedback
        in: query
      requestBody:
        content:
          application/json:
            schema:
              type: object
              title: Edits
              default: {}
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    delete:
      summary: Delete Task
      description: "Delete a task and all associated resources.\n\nArgs:\n----\n    task_id: ID of the task to delete\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing success/failure status\n\nRaises:\n------\n    HTTPException: If task not found, unauthorized, or deletion fails"
      operationId: delete_task_tasks__task_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel_ChangeResourceResponse_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/models:
    get:
      summary: Get Task Models
      description: "Get available models for a task.\n\nArgs:\n----\n    task_id: ID of the task to get models for\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing list of available and in-progress models\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: get_task_models_tasks__task_id__models_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/subtasks/{subtask_id}:
    delete:
      summary: Delete Subtask
      description: "Delete a subtask from a task.\n\nArgs:\n----\n    task_id: ID of the task containing the subtask\n    subtask_id: ID of the subtask to delete\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel indicating success/failure\n\nRaises:\n------\n    HTTPException: If task/subtask not found or unauthorized"
      operationId: delete_subtask_tasks__task_id__subtasks__subtask_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Subtask Id
        name: subtask_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/transforms/{transform_id}:
    delete:
      summary: Delete Transform
      description: "Delete a transform from a task.\n\nArgs:\n----\n    task_id: ID of the task containing the transform\n    transform_id: ID of the transform to delete\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel indicating success/failure\n\nRaises:\n------\n    HTTPException: If task/transform not found or unauthorized"
      operationId: delete_transform_tasks__task_id__transforms__transform_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Transform Id
        name: transform_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/datasets/{dataset_id}:
    get:
      summary: Get Items From Task Run
      description: "Get items from a task run for a specific dataset.\n\nArgs:\n----\n    task_id: ID of the task to get items from\n    dataset_id: ID of the dataset to get items from\n    eval: Whether to get evaluation set items\n    offset: Number of items to skip for pagination\n    max_items: Maximum number of items to return\n    filters: List of filters to apply to the query\n    order_bys: List of order by clauses to apply\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing the items and metadata\n\nRaises:\n------\n    HTTPException: If task/dataset not found or unauthorized"
      operationId: get_items_from_task_run_tasks__task_id__datasets__dataset_id__get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: false
        schema:
          type: boolean
          title: Eval
          default: false
        name: eval
        in: query
      - required: false
        schema:
          type: integer
          title: Offset
          default: 0
        name: offset
        in: query
      - required: false
        schema:
          type: integer
          title: Max Items
          default: 10
        name: max_items
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Order Bys
        name: order_bys
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/seedset:
    get:
      summary: Get Items From Seedset
      description: "Get items from a task's seedset with filtering and pagination.\n\nArgs:\n----\n    task_id: ID of the task to get seedset items from\n    offset: Number of items to skip for pagination\n    max_items: Maximum number of items to return\n    filters: List of filters to apply to the results\n    order_bys: List of fields to order results by\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing the filtered and paginated seedset items\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: get_items_from_seedset_tasks__task_id__seedset_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: false
        schema:
          type: integer
          title: Offset
          default: 0
        name: offset
        in: query
      - required: false
        schema:
          type: integer
          title: Max Items
          default: 10
        name: max_items
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Order Bys
        name: order_bys
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/evalset:
    get:
      summary: Get Items From Evalset
      description: "Get items from a task's evaluation set.\n\nArgs:\n----\n    task_id: ID of the task to get evaluation items from\n    model_id: Optional model ID to filter results\n    offset: Number of items to skip for pagination\n    max_items: Maximum number of items to return\n    filters: List of filters to apply to results\n    order_bys: List of fields to order results by\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing evaluation set items with:\n        - schema: Dataset schema\n        - items: List of evaluation items\n        - total_count: Total number of items\n        - task/dataset metadata\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: get_items_from_evalset_tasks__task_id__evalset_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: false
        schema:
          type: string
          title: Model Id
        name: model_id
        in: query
      - required: false
        schema:
          type: integer
          title: Offset
          default: 0
        name: offset
        in: query
      - required: false
        schema:
          type: integer
          title: Max Items
          default: 10
        name: max_items
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Order Bys
        name: order_bys
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    post:
      summary: Create Evalset
      description: "Create an evaluation set for a task by sampling items from a dataset.\n\nArgs:\n----\n    task_id: ID of the task to create evalset for\n    dataset_id: ID of the dataset to sample from\n    sampling_parameters: Parameters for sampling items\n    filters: List of filters to apply when sampling\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing success status\n\nRaises:\n------\n    HTTPException: If task/dataset not found or unauthorized"
      operationId: create_evalset_tasks__task_id__evalset_post
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SamplingEvent'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel_ChangeResourceResponse_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/runs/{dataset_id}/metrics:
    get:
      summary: Get Metrics For Task Run
      description: "Get metrics for a specific task run.\n\nArgs:\n----\n    task_id: ID of the task to get metrics for\n    dataset_id: ID of the dataset to get metrics for\n    filters: List of filters to apply when calculating metrics\n    eval: Whether to get metrics for evaluation mode\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing metrics data\n\nRaises:\n------\n    HTTPException: If task/dataset not found or unauthorized"
      operationId: get_metrics_for_task_run_tasks__task_id__runs__dataset_id__metrics_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: false
        schema:
          type: boolean
          title: Eval
          default: false
        name: eval
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/evalset/metrics:
    get:
      summary: Get Evalset Metrics For Task Run
      description: "Get evaluation metrics for a task's evaluation set.\n\nArgs:\n----\n    task_id: ID of the task to get metrics for\n    filters: Optional list of filters to apply to the evaluation set\n    model_id: Optional model ID to filter results by\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing metrics data with:\n        - Mapping of subtask IDs to list of MetricResult objects\n        - Each MetricResult contains metric name, value and support count\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: get_evalset_metrics_for_task_run_tasks__task_id__evalset_metrics_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: false
        schema:
          type: string
          title: Model Id
        name: model_id
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/runs/{dataset_id}:
    get:
      summary: Get Task Run
      description: "Get details about a specific task run.\n\nArgs:\n----\n    task_id: ID of the task to get run details for\n    dataset_id: ID of the dataset the task was run on\n    eval: If True, get evaluation run instead of regular run\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing the task run details\n\nRaises:\n------\n    HTTPException: If task/dataset not found or unauthorized"
      operationId: get_task_run_tasks__task_id__runs__dataset_id__get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: false
        schema:
          type: boolean
          title: Eval
          default: false
        name: eval
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    post:
      summary: Update Task Run
      operationId: update_task_run_tasks__task_id__runs__dataset_id__post
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: false
        schema:
          type: boolean
          title: Cancel Run
          default: false
        name: cancel_run
        in: query
      - required: false
        schema:
          type: integer
          title: Num Items
        name: num_items
        in: query
      - required: false
        schema:
          type: boolean
          title: Eval
          default: false
        name: eval
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    delete:
      summary: Clear Task Run
      description: "Delete a task run and its associated data.\n\nArgs:\n----\n    task_id: ID of the task to clear run for\n    dataset_id: ID of the dataset containing the run\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel indicating success/failure\n\nRaises:\n------\n    HTTPException: If task/dataset not found or unauthorized"
      operationId: clear_task_run_tasks__task_id__runs__dataset_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/runs:
    get:
      summary: Get Task Runs
      description: "Get all task runs for a specific task.\n\nArgs:\n----\n    task_id: ID of the task to get runs for\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing list of task runs with:\n        - id: str - Task run ID\n        - project_id: str - Project ID\n        - task_id: str - Task ID\n        - task_name: str - Task name\n        - model_name: str - Model name\n        - dataset_id: str - Dataset ID\n        - dataset_name: str - Dataset name\n        - status: str - Run status\n        - is_eval_run: bool - Whether this is an evaluation run\n        - created_at: datetime - Creation timestamp\n        - updated_at: datetime - Last update timestamp\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: get_task_runs_tasks__task_id__runs_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    post:
      summary: Update Task Run V2
      description: "Update or manage a task run for a specific task.\n\nArgs:\n----\n    task_id: ID of the task to update run for\n    dataset_id: Optional ID of dataset to run task on\n    cancel_run: Whether to cancel an existing run\n    num_items: Number of items to process in run\n    filters: List of filters to apply to dataset\n    eval: Whether this is an evaluation run\n    token: Access token for authentication\n\nReturns:\n-------\n    Response indicating success/failure\n\nRaises:\n------\n    HTTPException: If task not found or unauthorized"
      operationId: update_task_run_v2_tasks__task_id__runs_post
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: false
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: query
      - required: false
        schema:
          type: boolean
          title: Cancel Run
          default: false
        name: cancel_run
        in: query
      - required: false
        schema:
          type: integer
          title: Num Items
        name: num_items
        in: query
      - required: false
        schema:
          type: boolean
          title: Eval
          default: false
        name: eval
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/datasets/{dataset_id}/items/{item_id}/label:
    get:
      summary: Preview Labels V2
      description: "Preview labels for a specific item in a dataset.\n\nArgs:\n----\n    task_id: ID of the task to preview labels for\n    dataset_id: ID of the dataset containing the item\n    item_id: ID of the item to preview labels for\n    model_id: Optional model ID to use for generating labels\n    subtask_id: Optional subtask ID to filter labels for\n    token: Access token for authentication\n    generate_missing_labels: Whether to generate missing labels\n    generate_missing_explanations: Whether to generate missing explanations\n\nReturns:\n-------\n    ResponseModel containing the previewed labels\n\nRaises:\n------\n    HTTPException: If dataset/task not found or unauthorized"
      operationId: preview_labels_v2_tasks__task_id__datasets__dataset_id__items__item_id__label_get
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: true
        schema:
          type: string
          title: Item Id
        name: item_id
        in: path
      - required: false
        schema:
          type: string
          title: Model Id
        name: model_id
        in: query
      - required: false
        schema:
          type: string
          title: Subtask Id
        name: subtask_id
        in: query
      - required: false
        schema:
          type: boolean
          title: Generate Missing Labels
          default: true
        name: generate_missing_labels
        in: query
      - required: false
        schema:
          type: boolean
          title: Generate Missing Explanations
          default: false
        name: generate_missing_explanations
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
    post:
      summary: Edit Labels V2
      description: "Edit labels for a specific item in a dataset.\n\nArgs:\n----\n    task_id: ID of the task containing the item\n    dataset_id: ID of the dataset containing the item\n    item_id: ID of the item to edit labels for\n    label_edits: Dictionary containing label edits to apply\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel indicating success/failure\n\nRaises:\n------\n    HTTPException: If no label provided or validation fails"
      operationId: edit_labels_v2_tasks__task_id__datasets__dataset_id__items__item_id__label_post
      parameters:
      - required: true
        schema:
          type: string
          title: Task Id
        name: task_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: true
        schema:
          type: string
          title: Item Id
        name: item_id
        in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              title: Label Edits
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Tasks
  /tasks/{task_id}/evalset/items/{item_id}:
    delete:
      summary: Remove Item From Evalset
      description: "Remove an item from a task's evaluation set.\n\nArgs:\n----\n    task_id: ID of the task containing the evalset\n    item_id: ID of the item to remove from evalset\n    token: Access token for authentication\n\nReturns:\n-------\n    ResponseModel containing success/failure status\n\nRaises:\n------\n    HTTPException: If task/item not found or unauthorized"
      operationId: remove_item_from_evalset_tasks__task_id__evalset_items__item_id__delet

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/refuel-ai/refs/heads/main/openapi/refuel-ai-tasks-api-openapi.yml