Fleet · Schema

TaskGroupCreateRequest

CompanyArtificial IntelligenceAI AgentsReinforcement Learning EnvironmentsEvaluationSimulationTraining Data

Properties

Name Type Description
project_id object
name string
task object Shared parent-task fields for PROMPT mode. Required when members carry prompts; must be omitted in REFERENCE mode.
members array Members. In PROMPT mode each carries a prompt; in REFERENCE mode each carries an eval_task_id (+ optional eval_task_version_id).
View JSON Schema on GitHub

JSON Schema

fleetai-com-task-group-create-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fleetai-com/json-schema/fleetai-com-task-group-create-request-schema.json",
  "title": "TaskGroupCreateRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fleetai-com-task-groups-api-openapi.yml#/components/schemas/TaskGroupCreateRequest",
  "properties": {
    "project_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Project Id"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "title": "Name"
    },
    "task": {
      "anyOf": [
        {
          "$ref": "#/$defs/TaskGroupTaskSpec"
        },
        {
          "type": "null"
        }
      ],
      "description": "Shared parent-task fields for PROMPT mode. Required when members carry prompts; must be omitted in REFERENCE mode."
    },
    "members": {
      "items": {
        "$ref": "#/$defs/TaskGroupMemberSpec"
      },
      "type": "array",
      "minItems": 1,
      "title": "Members",
      "description": "Members. In PROMPT mode each carries a prompt; in REFERENCE mode each carries an eval_task_id (+ optional eval_task_version_id)."
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "name",
    "members"
  ],
  "$defs": {
    "SeedOverride": {
      "properties": {
        "seed_version_ids": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "maxItems": 32,
          "title": "Seed Version Ids",
          "description": "Complete seed-version selection; an empty list is valid for seedless releases."
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "seed_version_ids"
      ],
      "title": "SeedOverride",
      "description": "A complete registered seed set for a pinned environment release."
    },
    "TaskGroupMemberSpec": {
      "properties": {
        "prompt": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "title": "Prompt"
        },
        "label": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "title": "Label"
        },
        "env_variables": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Env Variables",
          "description": "Overrides the shared task.env_variables for this member."
        },
        "eval_task_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Eval Task Id"
        },
        "eval_task_version_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Eval Task Version Id"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "TaskGroupMemberSpec",
      "description": "One task-group member, in one of two shapes.\n\nPROMPT mode (legacy): carries a ``prompt`` (and optionally ``env_variables``)\nthat becomes a new ``eval_task_version`` under the shared task.\n\nREFERENCE mode (new): carries an existing ``eval_task_id`` and optionally a\npinned ``eval_task_version_id``. When the version is omitted the server pins\nthe task's latest (current) version."
    },
    "TaskGroupTaskSpec": {
      "properties": {
        "key": {
          "type": "string",
          "title": "Key"
        },
        "prompt": {
          "type": "null",
          "title": "Prompt",
          "description": "Prompt belongs on each task-group member."
        },
        "env_id": {
          "type": "string",
          "title": "Environment Id"
        },
        "verifier_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verifier Id"
        },
        "verifier_func": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verifier Func"
        },
        "version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version"
        },
        "environment_version_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Environment Version Id"
        },
        "seed_override": {
          "anyOf": [
            {
              "$ref": "#/$defs/SeedOverride"
            },
            {
              "type": "null"
            }
          ]
        },
        "seed_config": {
          "anyOf": [
            {
              "additionalProperties": {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Seed Config"
        },
        "env_variables": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Env Variables"
        },
        "metadata": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Metadata"
        },
        "expected_version_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expected Version Id",
          "description": "Current task version; required when replacing an existing task's tool policy."
        },
        "project_key": {
          "type": "null",
          "title": "Project Key",
          "description": "Derived from project_id for every created member task."
        },
        "data_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Data Id"
        },
        "data_version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Data Version"
        },
        "multi_app_seed_versions": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Data Versions",
          "description": "Per-component seed version pins. Keyed by component env_key; falls back to data_version for components not in the dict."
        },
        "verifier_status": {
          "type": "string",
          "title": "Verifier Status",
          "description": "Status for the verifier version (ACTIVE or PROPOSED)",
          "default": "ACTIVE"
        },
        "output_json_schema": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Output Json Schema",
          "description": "JSON schema for expected output format"
        },
        "factual_answer": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ],
          "title": "Factual Answer",
          "description": "Expected answer for research/factual tasks"
        },
        "graded": {
          "type": "null",
          "title": "Graded",
          "description": "Task groups do not accept grading targets here."
        },
        "task_modality": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Task Modality",
          "description": "Task modality (computer_use, tool_use, browser)"
        },
        "task_scenario_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Task Scenario ID",
          "description": "ID of an existing task scenario to link this task to"
        },
        "task_lifecycle_status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Task Lifecycle Status",
          "description": "Task lifecycle status (production, staging, development, deprecated)"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "key",
        "env_id"
      ],
      "title": "TaskGroupTaskSpec",
      "description": "Shared parent-task fields for task-group creation.\n\nCarries everything the underlying ``db.create_task`` needs EXCEPT the\nprompt (the prompt lives per-member on ``eval_task_versions``). Field names\ninherit from ``TaskRequest`` so task-create fields stay in sync with the\nstandalone create-task API."
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/fleetai-com-task-group-create-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.