TaskRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/TaskRequest",
  "title": "TaskRequest",
  "allOf": [
    {
      "$ref": "#/components/schemas/TaskBase"
    },
    {
      "type": "object",
      "properties": {
        "assignee": {
          "type": "string",
          "readOnly": false,
          "x-env-variable": true,
          "description": "Gid of a user.",
          "example": "12345",
          "nullable": true
        },
        "assignee_section": {
          "nullable": true,
          "type": "string",
          "description": "The *assignee section* is a subdivision of a project that groups tasks together in the assignee's \"My Tasks\" list. It can either be a header above a list of tasks in a list view or a column in a board view of \"My Tasks.\"\nThe `assignee_section` property will be returned in the response only if the request was sent by the user who is the assignee of the task. Note that you can only write to `assignee_section` with the gid of an existing section visible in the user's \"My Tasks\" list.",
          "example": "12345"
        },
        "custom_fields": {
          "description": "An object where each key is the GID of a custom field and its corresponding value is either an enum GID, string, number, object, or array (depending on the custom field type). See the [custom fields guide](/docs/custom-fields-guide) for details on creating and updating custom field values.",
          "type": "object",
          "additionalProperties": {
            "type": "string",
            "description": "\"{custom_field_gid}\" => Value (can be text, a number, etc.). For date, use format \"YYYY-MM-DD\" (e.g., 2019-09-15). For date-time, use ISO 8601 date string in UTC (e.g., 2019-09-15T02:06:58.147Z)."
          },
          "example": {
            "5678904321": "On Hold",
            "4578152156": "Not Started"
          }
        },
        "followers": {
          "type": "array",
          "description": "*Create-Only* An array of strings identifying users. These can either be the string \"me\", an email, or the gid of a user. In order to change followers on an existing task use `addFollowers` and `removeFollowers`.",
          "items": {
            "type": "string",
            "description": "Gid of a user."
          },
          "example": [
            "12345"
          ]
        },
        "parent": {
          "type": "string",
          "readOnly": false,
          "x-env-variable": true,
          "description": "Gid of a task.",
          "example": "12345",
          "nullable": true
        },
        "projects": {
          "type": "array",
          "description": "*Create-Only* Array of project gids. In order to change projects on an existing task use `addProject` and `removeProject`.",
          "items": {
            "type": "string",
            "description": "Gid of a project."
          },
          "example": [
            "12345"
          ]
        },
        "tags": {
          "type": "array",
          "description": "*Create-Only* Array of tag gids. In order to change tags on an existing task use `addTag` and `removeTag`.",
          "items": {
            "type": "string",
            "description": "Gid of a tag."
          },
          "example": [
            "12345"
          ]
        },
        "workspace": {
          "type": "string",
          "readOnly": false,
          "x-env-variable": true,
          "description": "Gid of a workspace.",
          "example": "12345"
        }
      }
    }
  ]
}