Get Subtasks
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/tasks/{task_id}/subtasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/tasks/{task_id}/subtasks"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.dcycle.io/v1/tasks/{task_id}/subtasks \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'{
"id": "<string>",
"title": "<string>",
"description": "<string>",
"due_date": "<string>",
"stage": "<string>",
"category": "<string>",
"assignees": {},
"completion_mode": "<string>",
"assigned_to": {},
"projects": {},
"comments": {},
"progress": {},
"tags": {}
}Get Subtasks
Retrieve all subtasks of a given task
GET
/
v1
/
tasks
/
{task_id}
/
subtasks
Get Subtasks
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/tasks/{task_id}/subtasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/tasks/{task_id}/subtasks"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.dcycle.io/v1/tasks/{task_id}/subtasks \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'{
"id": "<string>",
"title": "<string>",
"description": "<string>",
"due_date": "<string>",
"stage": "<string>",
"category": "<string>",
"assignees": {},
"completion_mode": "<string>",
"assigned_to": {},
"projects": {},
"comments": {},
"progress": {},
"tags": {}
}← Projects API
Retrieve all subtasks of a given parent task. Subtasks are created by setting
parent_task_id when creating a task.
Request
Headers
Path Parameters
Response
Returns an array of task objects. See List All Tasks for full field descriptions.Every user assigned to the task, all equally accountable. Each entry includes
completed_at,
set once that person has finished their own part (only meaningful when completion_mode is all).any (the first assignee to complete it finishes it for everyone) or all (every assignee must
complete their own part before the task is marked done).Example
curl "https://api.dcycle.io/v1/tasks/${TASK_ID}/subtasks" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}"
import requests
import os
response = requests.get(
f"https://api.dcycle.io/v1/tasks/{os.getenv('TASK_ID')}/subtasks",
headers={
"x-api-key": os.getenv("DCYCLE_API_KEY"),
"x-organization-id": os.getenv("DCYCLE_ORG_ID"),
},
)
subtasks = response.json()
print(f"{len(subtasks)} subtask(s)")
for st in subtasks:
print(f" - {st['title']} ({st['stage']})")
const axios = require('axios');
const { data: subtasks } = await axios.get(
`https://api.dcycle.io/v1/tasks/${process.env.TASK_ID}/subtasks`,
{
headers: {
'x-api-key': process.env.DCYCLE_API_KEY,
'x-organization-id': process.env.DCYCLE_ORG_ID,
},
}
);
console.log(`${subtasks.length} subtask(s)`);
Successful Response
[
{
"id": "subtask-uuid-1",
"title": "Upload January invoices",
"description": "",
"due_date": "2025-07-10",
"stage": "completed",
"category": "data_collection",
"assignees": [
{
"id": "user-uuid",
"first_name": "Ana",
"last_name": "García",
"completed_at": "2025-07-08T09:00:00Z"
}
],
"completion_mode": "any",
"assigned_to": {
"id": "user-uuid",
"first_name": "Ana",
"last_name": "García"
},
"projects": [
{ "id": "project-uuid", "name": "Carbon Footprint 2025" }
],
"comments": [],
"progress": 100.0,
"tags": []
}
]
Common Errors
401 Unauthorized
Cause: Missing or invalid API key{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}
403 Forbidden
Cause: The authenticated user is not a member of the organization{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}
404 Not Found
Cause: The task does not exist or belongs to another organization{"detail": "Not Found"}
Related Endpoints
Get Task
Get parent task details
Create Task
Create a subtask with parent_task_id
Was this page helpful?