---
title: "POST /tasks/{taskId}/subtasks"
method: POST
path: "/tasks/{taskId}/subtasks"
tags: ["slash-task"]
---

# POST /tasks/{taskId}/subtasks

`POST /tasks/{taskId}/subtasks`

## Path parameters

- `taskId` integer, required

## Request body

- TaskDto
  - `tenantId` integer
  - `taskId` integer
  - `taskTitle` string
  - `description` string
  - `descriptionMentionedUserIds` integer[]
  - `startDate` string, date-time
  - `dueDate` string, date-time
  - `noOfDays` integer
  - `completion` integer
  - `priority` TaskPriorityDto
    - `tenantId` integer
    - `taskPriorityId` integer
    - `priorityLabel` string
    - `color` string
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `modifiedBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `default` boolean
    - `primary` boolean
  - `status` TaskStatusDto
    - `tenantId` integer
    - `taskStatusId` integer
    - `statusName` string
    - `color` string
    - `statusCategory` string
    - `projectId` integer
    - `spaceId` integer
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `modifiedBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `default` boolean
    - `primary` boolean
  - `taskTags` TagDto[]
    - `tenantId` integer
    - `tagId` integer
    - `tagName` string
    - `color` string
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `modifiedBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `createdTime` string, date-time
    - `modifiedTime` string, date-time
    - `taskCount` integer
    - `projectCount` integer
  - `overdueStatus` boolean
  - `parentId` integer
  - `taskListId` integer
  - `createdByMail` string
  - `senderName` string
  - `createdBy` UserMinimalDto
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `modifiedBy` UserMinimalDto
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `modifiedTime` string, date-time
  - `createdTime` string, date-time
  - `deleted` boolean
  - `deletedBy` UserMinimalDto
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `deletedTime` string, date-time
  - `completedTime` string, date-time
  - `timer` integer
  - `messageId` string
  - `owners` UserMinimalDto[]
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `followers` UserMinimalDto[]
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `taggedUsers` UserMinimalDto[]
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `members` UserMinimalDto[]
    - `userId` integer
    - `firstName` string
    - `email` string
    - `profilePicURL` string
    - `profilePicColor` string
    - `provider` string
    - `role` OrgRoleDto
      - `orgRoleId` integer
      - `roleName` string
  - `projectId` integer
  - `spaceId` integer
  - `projectName` string
  - `spaceName` string
  - `subTaskCount` integer
  - `parentCommentCount` integer
  - `customFields` TaskCustomFieldDto[]
    - `tenantId` integer
    - `taskCustomFieldId` integer
    - `fieldName` string
    - `description` string
    - `fieldType` string
    - `fieldValue` TaskFieldValue[]
      - `taskId` integer
      - `value` unknown
    - `fieldIcon` string
    - `spaceId` integer
    - `projectId` integer
    - `associatedId` integer
    - `level` 'ORG' | 'SPACE' | 'LOCAL'
    - `active` boolean
    - `order` integer
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `modifiedBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `createdTime` string, date-time
    - `modifiedTime` string, date-time
    - `options` CustomFieldOptionDto[]
      - `optionId` integer
      - `optionName` string, required
      - `color` string
      - `spaceId` integer
      - `projectId` integer
      - `taskCustomFieldId` integer
  - `blockedByTasks` TaskDependencyDto[]
    - `tenantId` integer
    - `dependencyId` integer
    - `spaceId` integer
    - `projectId` integer
    - `dependencyType` string
    - `blocking` TaskResponseDto
      - `taskId` integer
      - `projectId` integer
      - `spaceId` integer
      - `taskTitle` string
      - `status` TaskStatusDto
        - `tenantId` integer
        - `taskStatusId` integer
        - `statusName` string
        - `color` string
        - `statusCategory` string
        - `projectId` integer
        - `spaceId` integer
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `default` boolean
        - `primary` boolean
      - `dueDate` string, date-time
      - `owners` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `isInternal` boolean
    - `blockedBy` TaskResponseDto
      - `taskId` integer
      - `projectId` integer
      - `spaceId` integer
      - `taskTitle` string
      - `status` TaskStatusDto
        - `tenantId` integer
        - `taskStatusId` integer
        - `statusName` string
        - `color` string
        - `statusCategory` string
        - `projectId` integer
        - `spaceId` integer
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `default` boolean
        - `primary` boolean
      - `dueDate` string, date-time
      - `owners` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `isInternal` boolean
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `createdTime` string, date-time
  - `blockingTasks` TaskDependencyDto[]
    - `tenantId` integer
    - `dependencyId` integer
    - `spaceId` integer
    - `projectId` integer
    - `dependencyType` string
    - `blocking` TaskResponseDto
      - `taskId` integer
      - `projectId` integer
      - `spaceId` integer
      - `taskTitle` string
      - `status` TaskStatusDto
        - `tenantId` integer
        - `taskStatusId` integer
        - `statusName` string
        - `color` string
        - `statusCategory` string
        - `projectId` integer
        - `spaceId` integer
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `default` boolean
        - `primary` boolean
      - `dueDate` string, date-time
      - `owners` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `isInternal` boolean
    - `blockedBy` TaskResponseDto
      - `taskId` integer
      - `projectId` integer
      - `spaceId` integer
      - `taskTitle` string
      - `status` TaskStatusDto
        - `tenantId` integer
        - `taskStatusId` integer
        - `statusName` string
        - `color` string
        - `statusCategory` string
        - `projectId` integer
        - `spaceId` integer
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `default` boolean
        - `primary` boolean
      - `dueDate` string, date-time
      - `owners` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `isInternal` boolean
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `createdTime` string, date-time
  - `parent` boolean
  - `internal` boolean
  - `recurring` boolean
  - `isInternal` boolean

## Response `200`

OK

- ResponseFormat
  - `success` boolean
  - `message` string
  - `data` unknown
  - `errorCode` integer
  - `errors` unknown

---

[API](https://skmtc.net/astravue/apis/astravue-api.md) · [All operations](https://skmtc.net/astravue/apis/astravue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astravue/astravue-api/versions/237f5bbd4029/schema)
