RoadOps Developer Docs - Task Subtasks

List task subtasks

GET/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/subtasks

Lists subtasks for a visible Task.

Required scopes: task:read

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

`data`	`object[]`
`data[].id`	`string:uuid` Subtask identifier.
`data[].orgId`	`string:uuid` Organization identifier.
`data[].taskId`	`string:uuid` Parent Task identifier.
`data[].dayId`	`string:uuid` Associated Day identifier used for activity and sync.
`data[].title`	`string` Subtask title.
`data[].isCompleted`	`boolean` Whether the subtask is complete.
`data[].order`	`integer` Subtask display order.
`data[].createdBy`	`string:uuid` RoadOps user ID that created the subtask.
`data[].createdAt`	`string:date-time` UTC subtask creation timestamp.
`data[].updatedAt`	`string:date-time` UTC timestamp of the latest subtask change.
`data[].isDeleted`	`boolean` Soft-delete flag.
`data[].version`	`integer` Current subtasks-item aggregate version.
`data[].cursor`	`integer` Latest cursor projected into this subtask.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.

POST/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/subtasks

Adds a lightweight subtask to a Task.

Required scopes: task:write

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`id`	`string:uuid`
`title`required	`string` Subtask title.
`order`required	`integer` Subtask display order.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

PATCH/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/subtasks/{subtaskId}

Updates subtasks text, order, or completion state.

Required scopes: task:write

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`path.subtaskId`required	`string:uuid` Subtask identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`expectedVersion`	`integer`
`updates`required	`object`
`updates.title`	`string` Subtask title.
`updates.isCompleted`	`boolean` Whether the subtask is complete.
`updates.order`	`integer` Subtask display order.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

DELETE/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/subtasks/{subtaskId}

Deletes a Task subtask.

Required scopes: task:write

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`path.subtaskId`required	`string:uuid` Subtask identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.