Gtdagenda.com API

The Gtdagenda API is implemented as a PHP page that accepts GET or POST requests and returns JSON or XML.

API clients must hit the URL http://app.gtdagenda.com/api2.php

All API requests must have a key argument indicating the user, except cmd=login.

Tasks


Methods

MethodExpected parameters

taskList

taskfilterid (type: integer, Task Filter id)
set_taskfilter_current (type: boolean, If set to 1, task filter will be set as current. Used in conjunction with taskfilterid.)
projectid (type: integer, Project id)
contextid (type: integer, Context id)
goalid (type: integer, Goal id)
categoryid (type: integer, Category id)
priority (type: integer, Priority: 1 to 5)
next (type: boolean, Next Action, use: 1 or 0)
done (type: boolean, Task done, use: 1 or 0)
duemonth (type: integer, Due month, eg: 10)
dueday (type: integer, Due day, eg: 29)
dueyear (type: integer, Due year, eg: 2012)
search (type: string, Search string in task name or note)
lastmodified_since (type: integer, List only tasks modified after this timestamp)
sortby (type: string, Sort by: project, context, priority, status, due, goal, category, next_first, date, name, done)
sortby2 (type: string, Sort by: project, context, priority, status, due, goal, category, next_first, date, name, done)
sortby3 (type: string, Sort by: project, context, priority, status, due, goal, category, next_first, date, name, done)

taskView

id (type: integer, required: Yes, Task id)

taskCreate

name (type: string, required: Yes, Task name)
type (type: string, Task type, use: 'task' (default), 'memo', 'meeting' or 'birthday')
tasktypeid (type: integer, Task type Id)
assignedto (type: string, Assigned to User id)
priority (type: integer, Task priority, 1-5)
projectid (type: integer, Project id)
contextid (type: integer, Context id)
next (type: boolean, Next Action, default: 0)
duemonth (type: integer, Due month, eg: 10)
dueday (type: integer, Due day, eg: 29)
dueyear (type: integer, Due year, eg: 2012)
duedatehuman (type: string, Can be used instead of duemonth+dueday+dueyear, eg 05/06/2013. Takes into account the user's date format (us/eu).)
duehour (type: integer, Due hour, eg: 14)
dueminute (type: integer, Due minute, eg: 50)
duration (type: integer, Duration in seconds)
repeats (type: string, Task Repeats. Accepted values: 'no', 'day', 'weekday', 'week', 'month', or 'year')
active (type: boolean, Active task, default: 1)
someday (type: boolean, Someday/Maybe task, default: 0)
archive (type: boolean, Archived task, default: 0)
done (type: boolean, Task done, default: 0)
note (type: string, Task note)

taskEdit

id (type: string, required: Yes, Task Id)
name (type: string, Task name)
type (type: string, Task type, use: 'task' (default), 'memo', 'meeting' or 'birthday')
tasktypeid (type: integer, Task type Id)
assignedto (type: string, Assigned to User id)
priority (type: integer, Task priority, 1-5)
projectid (type: integer, Project id)
contextid (type: integer, Context id)
next (type: boolean, Next Action, default: 0)
duemonth (type: integer, Due month, eg: 10)
dueday (type: integer, Due day, eg: 29)
dueyear (type: integer, Due year, eg: 2012)
duedatehuman (type: string, Can be used instead of duemonth+dueday+dueyear, eg 05/06/2013. Takes into account the user's date format (us/eu).)
repeats (type: string, Task Repeats. Accepted values: 'no', 'day', 'weekday', 'week', 'month', or 'year')
active (type: boolean, Active task, default: 1)
someday (type: boolean, Someday/Maybe task, default: 0)
archive (type: boolean, Archived task, default: 0)
done (type: boolean, Task done, default: 0)
note (type: string, Task note)

taskBatchEdit

ids (type: string, required: Yes, Task ids in json format, eg: [1,2])
name (type: string, Task name)
type (type: string, Task type, use: 'task' (default), 'memo', 'meeting' or 'birthday')
tasktypeid (type: integer, Task type Id)
assignedto (type: string, Assigned to User id)
priority (type: integer, Task priority, 1-5)
projectid (type: integer, Project id)
contextid (type: integer, Context id)
next (type: boolean, Next Action, default: 0)
duemonth (type: integer, Due month, eg: 10)
dueday (type: integer, Due day, eg: 29)
dueyear (type: integer, Due year, eg: 2012)
repeats (type: string, Task Repeats. Accepted values: 'no', 'day', 'weekday', 'week', 'month', or 'year')
active (type: boolean, Active task, default: 1)
someday (type: boolean, Someday/Maybe task, default: 0)
archive (type: boolean, Archived task, default: 0)
done (type: boolean, Task done, default: 0)
note (type: string, Task note)

taskDelete

id (type: integer, required: Yes, Task Id)

taskBatchDelete

ids (type: string, required: Yes, Task ids in json format, eg: [1,2])

getTaskDeletedIds

deleted_since (type: integer, Deleted since timestamp)

taskTypeList

taskTypeView

id (type: integer, required: Yes, Task type id)

taskTypeCreate

name (type: string, required: Yes, Task type name)
default (type: boolean, If set to 1 will make the task type default)

taskTypeEdit

id (type: integer, required: Yes, Task type Id)
name (type: string, Task type name)

taskTypeDelete

id (type: integer, required: Yes, Task type Id)

subTaskList

taskid (type: integer, required: Yes, Task Id)

subTaskView

id (type: integer, required: Yes, Subtask Id)

subTaskCreate

taskid (type: integer, required: Yes, Task Id)
name (type: string, required: Yes, Subtask name)
order (type: integer, Subtask order, 1-99, default:10)
done (type: boolean, Subtask done, default:0)

subTaskEdit

id (type: integer, required: Yes, Subtask Id)
name (type: string, Subtask name)
order (type: integer, Subtask order)
done (type: boolean, Subtask done)

subTaskDelete

id (type: integer, required: Yes, Subtask Id)

taskFilterList

taskFilterView

id (type: integer, required: Yes, Task filter Id)

taskFilterCreate

name (type: string, required: Yes, Filter name)
shared (type: boolean, Shared filter, default: 0)
done (type: boolean, Task done, use: -1,0,1, default:0)
search (type: string, Search string in task name or note)
category (type: integer, Category id)
goal (type: integer, Goal id)
project (type: integer, Project id)
context (type: integer, Context id)
type (type: integer, Task type id)
next (type: boolean, Next action)
priorityrange (type: integer, Priority range)
priority (type: integer, Priority)
opened (type: integer, Opened)
closed (type: integer, Closed)
due (type: integer, Due)
month (type: integer, Due month)
day (type: integer, Due day)
year (type: integer, Due year)
active (type: integer, Active task, default:1)
someday (type: integer, Someday/Maybe task, default:0)
archive (type: integer, Archived task, default:0)
sortby (type: integer, Sort by)
sortby2 (type: integer, Then by)
sortby3 (type: integer, Then by)
limit (type: integer, Tasks per page, use 0 for max.)

taskFilterDelete

id (type: integer, required: Yes, Task filter Id)

currentTaskFilterAlter

presaved (type: string, Presaved filter: inbox,next or null)
done (type: boolean, Task done, use: -1,0,1)
search (type: string, Search string in task name or note)
category (type: integer, Category id)
goal (type: integer, Goal id)
project (type: integer, Project id)
context (type: integer, Context id)
type (type: integer, Task type id)
next (type: boolean, Next action)
priorityrange (type: integer, Priority range)
priority (type: integer, Priority)
opened (type: integer, Opened)
closed (type: integer, Closed)
due (type: integer, Due)
month (type: integer, Due month)
day (type: integer, Due day)
year (type: integer, Due year)
active (type: integer, Active task, default:1)
someday (type: integer, Someday/Maybe task, default:0)
archive (type: integer, Archived task, default:0)
sortby (type: integer, Sort by)
sortby2 (type: integer, Then by)
sortby3 (type: integer, Then by)
limit (type: integer, Tasks per page, use 0 for max.)

currentTaskFilterSave

presaved (type: string, Presaved filter: inbox,next or null)
name (type: string, required: Yes, Filter name, if changed the filter will be saved as new)

currentTaskFilterReset

presaved (type: string, Presaved filter: inbox,next or null)

currentTaskFilterView

Introduction

Account

Users

Groups

Subscriptions

Priorities

Contexts

Projects

Calendar

Tasks

Goals

Checklists

Files

Notes

Custom Fields

Notifications


LISTING

VIEWING

CREATING

MODIFYING

DELETING


Reference Data