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.

MODIFYING


Methods

MethodExpected parameters

accountEdit

firstname (type: string, First name)
lastname (type: string, Last name)
email (type: string, Email)
password (type: string, Password)
ssl (type: boolean, SSL On, use 1 or 0)
ical (type: boolean, iCal feed On, use 1 or 0)
priority (type: integer, Default priority, choose from: 1, 2, 3, 4, 5)
min1nxt (type: boolean, Minimum 1 next action in project, use 1 or 0)
remindcal (type: boolean, Email notify Due tasks, use 1 or 0)
remindnas (type: boolean, Send Next Actions daily by email, use 1 or 0)
remindwall (type: boolean, Send Vision Wall daily by email, use 1 or 0)
notifyassigned (type: boolean, Send email when a task is assigned, use 1 or 0)
notifyassignedsms (type: boolean, Send sms when a task is assigned, use 1 or 0)
company (type: string, Company)
language (type: string, Language, choose from: da, de, en, es, fr, hr, it, nl, no, pl, pt-br, ro, ru, sv, jp, be)
theme (type: string, Color theme, choose from: white, grey, blue, green, pink)
timezone (type: string, Timezone, default: US/Central)
dateformat (type: string, Date format, us or eu, default: us)

setCompany

name (type: string, required: Yes, Company name)

userEdit

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

settingsEdit

expandedmenu (type: boolean, Expanded menu, 0 or 1)
sortchecklists (type: string, Sort checklists by: priority, label, goal, project, context, name, id)
sortgoals (type: string, Sort goals by: priority, category, name, id)
sortprojects (type: string, Sort projects by: priority, goal, name, id)

groupEdit

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

priorityEdit

nr (type: integer, required: Yes, Priority number, 1-5)
name (type: string, Priority name)
color (type: string, Priority color)

prioritiesReset

contextEdit

id (type: integer, required: Yes, Context id)
name (type: string, Context name)
order (type: integer, Context order)
color (type: string, Context background color)
bordercolor (type: string, Context border color)
textcolor (type: string, Context text color)
latitude (type: double, Context latitude)
longitude (type: double, Context longitude)
address (type: string, Context address)

projectEdit

id (type: string, required: Yes, Project Id)
name (type: string, Project name)
goalid (type: integer, Goal Id)
priority (type: integer, Project priority)
duemonth (type: integer, Due month)
dueday (type: integer, Due day)
dueyear (type: integer, Due year)
active (type: boolean, Active project)
someday (type: boolean, Someday/Maybe project)
archive (type: boolean, Archived project)
done (type: boolean, Project closed)
note (type: string, Project note)

projectFilterEdit

id (type: integer, required: Yes, Filter id)
name (type: string, Filter name)
shared (type: boolean, Shared filter, default: 0)
category (type: integer, Category id)
goal (type: integer, Goal id)
opened (type: integer, Opened)
closed (type: integer, Closed)
priorityrange (type: integer, Priority range)
priority (type: integer, Priority)
done (type: integer, Project closed, default:0)
active (type: integer, Active project, default:1)
someday (type: integer, Someday/Maybe project, default:0)
archive (type: integer, Archived project, default:0)
sortby (type: integer, Sort by)
sortby2 (type: integer, Then by)
sortby3 (type: integer, Then by)
limit (type: integer, Projects per page, use 0 for unlimited.)

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)

taskTypeEdit

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

subTaskEdit

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

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.)

goalEdit

id (type: integer, required: Yes, Goal Id)
name (type: string, Goal name)
priority (type: integer, Goal priority)
timeline (type: string, Goal timeline)
categoryid (type: integer, Category Id)
active (type: boolean, Active goal)
someday (type: boolean, Someday/Maybe goal)
archive (type: boolean, Archived project)
done (type: boolean, Goal done)
note (type: string, Goal note)
color (type: string, Goal background color)
bordercolor (type: string, Goal border color)
textcolor (type: string, Goal text color)

goalCategoryEdit

id (type: integer, required: Yes, Category id)
name (type: string, Category name)
order (type: integer, Category sort order)

checkGroupEdit

id (type: integer, required: Yes, Checkgroup Id)
name (type: integer, Checkgroup name)
checksaday (type: integer, How many checkboxes in a day)
checkgrouplabelid (type: integer, Label Id)
monday (type: boolean, Due on Monday)
tuesday (type: boolean, Due on Tuesday)
wednesday (type: boolean, Due on Wednesday)
thursday (type: boolean, Due on Thursday)
friday (type: boolean, Due on Friday)
saturday (type: boolean, Due on Saturday)
sunday (type: boolean, Due on Sunday)
priority (type: integer, Priority)
assignedto (type: integer, Assigned to User id)
contextid (type: integer, Context id)
projectid (type: integer, Project id)

checkGroupLabelEdit

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

fileEdit

id (type: integer, required: Yes, File id)
projectid (type: integer, Context id)
contextid (type: integer, Context id)
taskid (type: integer, Task id)

noteEdit

pushSubscriptionEdit

id (type: integer, required: Yes, Subscription Id)
description (type: string, Subscription description.)

pushSubscriptionVerify

id (type: string, required: Yes, Subscription Id)
code (type: string, required: Yes, Subscription Verification Code)

Introduction

Account

Users

Groups

Subscriptions

Priorities

Contexts

Projects

Calendar

Tasks

Goals

Checklists

Files

Notes

Custom Fields

Notifications


LISTING

VIEWING

CREATING

MODIFYING

DELETING


Reference Data