List All Tasks
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/projects/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/projects/tasks"
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/projects/tasks \
--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": {}
}List All Tasks
Retrieve all tasks linked to projects in your organization
GET
/
v1
/
projects
/
tasks
List All Tasks
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/projects/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/projects/tasks"
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/projects/tasks \
--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 tasks linked to projects within your organization. Returns tasks with their associated projects, comments, and assignee information.
Request
Headers
Response
Returns an array of task objects.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/projects/tasks" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}"
import requests
import os
response = requests.get(
"https://api.dcycle.io/v1/projects/tasks",
headers={
"x-api-key": os.getenv("DCYCLE_API_KEY"),
"x-organization-id": os.getenv("DCYCLE_ORG_ID"),
},
)
tasks = response.json()
for task in tasks:
print(f"{task['title']} ({task['stage']}) — due {task['due_date']}")
const axios = require('axios');
const { data: tasks } = await axios.get(
'https://api.dcycle.io/v1/projects/tasks',
{
headers: {
'x-api-key': process.env.DCYCLE_API_KEY,
'x-organization-id': process.env.DCYCLE_ORG_ID,
},
}
);
tasks.forEach(t => console.log(`${t.title} (${t.stage}) — due ${t.due_date}`));
Successful Response
[
{
"id": "task-uuid",
"title": "Review electricity invoices Q1",
"description": "Verify all Q1 invoices are uploaded",
"due_date": "2025-03-31",
"stage": "in_progress",
"category": "data_collection",
"organization_id": "org-uuid",
"assignees": [
{
"id": "user-uuid",
"first_name": "Ana",
"last_name": "García",
"email": "ana@example.com",
"completed_at": null
}
],
"completion_mode": "any",
"assigned_to": {
"id": "user-uuid",
"first_name": "Ana",
"last_name": "García",
"email": "ana@example.com"
},
"projects": [
{
"id": "project-uuid",
"name": "Carbon Footprint 2025"
}
],
"comments": [],
"progress": 60.0,
"tags": ["invoices", "Q1"]
}
]
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"}
Related Endpoints
List Project Tasks
List tasks for a specific project
Create Task
Create a new task
Was this page helpful?