Tasks

Fields

cid
task project-wide unique identifier number
id
task unique identifier number
parent_id
parent task unique identifier number
status
task status (0 = open, 1 = finished)
title
task title string
description
task description string
due_date
task due date
created-at
task creation time
updated-at
task last update time
tags
an array of tags. Only has the name field
ref_tags
an array of tags. Only has the name field
assignee_id
task assignee identifier number - only when returning an array of tasks
author_id
task author identifier number - only when returning an array of tasks
author
See User's Fields - only when returning the specific task
assignee
See User's Fields - only when returning the specific task
comments
an array of comments. See Comment's Fields - only when returning the specific task

Methods

get_all

returns all tasks in a category, all tasks child of a task or all categories with tasks

Parameters

  • category_id: CATEGORY_ID (category unique identifier #) - not mandatory
  • id: TASK_CID (project-wide unique task identifier #) - not mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/project_alias/api/tasks/get_all - all categories with tasks

	http://company_alias.goplanapp.com/project_alias/api/tasks/get_all?category_id=5 - all tasks within a category

	http://company_alias.goplanapp.com/project_alias/api/tasks/get_all/7 - all childs of a task

	

	http://company_alias.goplanapp.com/api/tasks/get_all?project=project_alias

	http://company_alias.goplanapp.com/api/tasks/get_all?category_id=5&format;=json&callback;=handlerFunction&project;=project_alias

	http://company_alias.goplanapp.com/api/tasks/get_all?id=7&project;=project_alias

Output Formats

  • XML - all tasks in a category

    
<?xml version="1.0" encoding="UTF-8"?>
    
<tasks type="array">
    
	<task>
    
		<assignee-id type="integer" nil="true"></assignee-id>
    
		<author-id type="integer">1</author-id>
    
		<cid type="integer">17</cid>
    
		<created-at type="datetime">2009-03-30T17:22:22+01:00</created-at>
    
		<description>Build the API</description>
    
		<due-date type="date" nil="true"></due-date>
    
		<id type="integer">19</id>
    
		<parent-id type="integer" nil="true"></parent-id>
    
		<status type="integer">0</status>
    
		<title>API</title>
    
		<updated-at type="datetime">2009-04-03T19:05:16+01:00</updated-at>
    
		<ref-tags type="array"/>
    
		<tags type="array">
    
			<tag>
    
				<name>testes</name>
    
			</tag>
    
		</tags>
    
	 </task>
    
</tasks>

  • JSON - all tasks in a category

    
[{"task": {"created_at": "2009/03/30 17:22:22 +0100", "title": "API", "assignee_id": null, "updated_at": "2009/04/03 19:05:16 +0100", "id": 19, "description": "Build the API", "parent_id": null, "due_date": null, "cid": 17, "author_id": 1, "status": 0}}]

  • XML - all tasks child of a task

    
<?xml version="1.0" encoding="UTF-8"?>
    
<tasks type="array">
    
	<task>
    
		<assignee-id type="integer" nil="true"></assignee-id>
    
		<author-id type="integer">1</author-id>
    
		<cid type="integer">19</cid>
    
		<created-at type="datetime">2009-03-30T17:24:40+01:00</created-at>
    
		<description>Test tasks</description>
    
		<due-date type="date" nil="true"></due-date>
    
		<id type="integer">21</id>
    
		<parent-id type="integer">20</parent-id>
    
		<status type="integer">0</status>
    
		<title>Testes</title>
    
		<updated-at type="datetime">2009-03-30T17:24:40+01:00</updated-at>
    
		<ref-tags type="array"/>
    
		<tags type="array">
    
			<tag>
    
				<name>testes</name>
    
			</tag>
    
		</tags>
    
	</task>
    
</tasks>

  • JSON - all tasks child of a task

    
[{"task": {"created_at": "2009/03/30 17:24:40 +0100", "title": "Testes", "assignee_id": null, "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "description": "Test tasks", "parent_id": 20, "due_date": null, "cid": 19, "author_id": 1, "status": 0}}]

  • XML - all categories with tasks

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task-categories type="array">
    
	<task-category>
    
		<created-at type="datetime">2009-03-26T19:08:00+00:00</created-at>
    
		<id type="integer">4</id>
    
		<name>Development</name>
    
		<updated-at type="datetime">2009-04-02T14:37:45+01:00</updated-at>
    
		<tasks type="array">
    
			<task>
    
				<assignee-id type="integer" nil="true"></assignee-id>
    
				<author-id type="integer">1</author-id>
    
				<cid type="integer">17</cid>
    
				<created-at type="datetime">2009-03-30T17:22:22+01:00</created-at>
    
				<description>Build the API</description>
    
				<due-date type="date" nil="true"></due-date>
    
				<id type="integer">19</id>
    
				<parent-id type="integer" nil="true"></parent-id>
    
				<status type="integer">0</status>
    
				<title>API</title>
    
				<updated-at type="datetime">2009-04-03T19:05:16+01:00</updated-at>
    
				<ref-tags type="array"/>
    
				<tags type="array">
    
					<tag>
    
						<name>testes</name>
    
					</tag>
    
				</tags>
    
			</task>
    
		</tasks>
    
	</task-category>
    
	<task-category>
    
		<created-at type="datetime">2009-03-17T15:20:30+00:00</created-at>
    
		<id type="integer">1</id>
    
		<name>Uncategorized</name>
    
		<updated-at type="datetime">2009-03-17T15:20:30+00:00</updated-at>
    
		<tasks type="array">
    
			<task>
    
				<assignee-id type="integer" nil="true"></assignee-id>
    
				<author-id type="integer">1</author-id>
    
				<cid type="integer">1</cid>
    
				<created-at type="datetime">2009-03-17T19:49:14+00:00</created-at>
    
				<description>We must test stuff</description>
    
				<due-date type="date" nil="true"></due-date>
    
				<id type="integer">1</id>
    
				<parent-id type="integer" nil="true"></parent-id>
    
				<status type="integer">0</status>
    
				<title>Something to test</title>
    
				<updated-at type="datetime">2009-03-17T19:49:14+00:00</updated-at>
    
				<ref-tags type="array"/>
    
				<tags type="array">
    
					<tag>
    
						<name>testes</name>
    
					</tag>
    
				</tags>
    
			</task>
    
			<task>
    
				<assignee-id type="integer">1</assignee-id>
    
				<author-id type="integer">1</author-id>
    
				<cid type="integer">2</cid>
    
				<created-at type="datetime">2009-03-17T19:49:16+00:00</created-at>
    
				<description>We must test the tickets</description>
    
				<due-date type="date" nil="true"></due-date>
    
				<id type="integer">2</id>
    
				<parent-id type="integer" nil="true"></parent-id>
    
				<status type="integer">0</status>
    
				<title>Ticket testing</title>
    
				<updated-at type="datetime">2009-03-17T19:49:16+00:00</updated-at>
    
				<ref-tags type="array"/>
    
				<tags type="array">
    
					<tag>
    
						<name>testes</name>
    
					</tag>
    
				</tags>
    
			</task>
    
		</tasks>
    
	</task-category>
    
</task-categories>

  • JSON - all categories with tasks

    
handlerFunction([{"task_category": {"name": "lindo", "created_at": "2009/03/26 19:08:00 +0000", "updated_at": "2009/04/02 14:37:45 +0100", "tasks": [{"created_at": "2009/03/30 17:22:22 +0100", "title": "API", "assignee_id": null, "updated_at": "2009/04/03 19:05:16 +0100", "id": 19, "description": "Build the API", "parent_id": null, "due_date": null, "cid": 17, "author_id": 1, "status": 0}], "id": 4}}, {"task_category": {"name": "Uncategorized", "created_at": "2009/03/17 15:20:30 +0000", "updated_at": "2009/03/17 15:20:30 +0000", "tasks": [{"created_at": "2009/03/17 19:49:14 +0000", "title": "Something to test", "assignee_id": null, "updated_at": "2009/03/17 19:49:14 +0000", "id": 1, "description": "We must test stuff", "parent_id": null, "due_date": null, "cid": 1, "author_id": 1, "status": 0}, {"created_at": "2009/03/17 19:49:16 +0000", "title": "Ticket testing", "assignee_id": 1, "updated_at": "2009/03/17 19:49:16 +0000", "id": 2, "description": "We must test the tickets"  "parent_id": null, "due_date": null, "cid": 2, "author_id": 1, "status": 0}}])

get

returns a single task information

Parameters

  • id: TASK_CID (project-wide unique task identifier #) - mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/projectalias/api/tasks/get/6

	http://company_alias.goplanapp.com/api/tasks/get?id=6&project;=projectalias&format;=json&callback;=handler

Output Formats

  • XML

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task>
    
	<cid type="integer">18</cid>
    
	<created-at type="datetime">2009-03-30T17:23:44+01:00</created-at>
    
	<description>teste</description>
    
	<due-date type="date" nil="true"></due-date>
    
	<id type="integer">20</id>
    
	<parent-id type="integer" nil="true"></parent-id>
    
	<status type="integer">0</status>
    
	<title>teste</title>
    
	<updated-at type="datetime">2009-03-30T17:23:44+01:00</updated-at>
    
	<ref-tags type="array"/>
    
	<author>
    
		<alias>john</alias>
    
		<created-at type="datetime">2009-03-17T15:05:51+00:00</created-at>
    
		<email>[email protected]</email>
    
		<name>John</name>
    
		<picture-url>http://goplanapp.com/content/server.jpg</picture-url>
    
		<time-zone>Lisbon</time-zone>
    
		<updated-at type="datetime">2009-04-06T13:17:08+01:00</updated-at>
    
		<user-type type="integer">0</user-type>
    
	</author>
    
	<tags type="array">
    
		<tag>
    
			<name>testes</name>
    
		</tag>
    
	</tags>
    
	<comments type="array">
    
		<comment>
    
			<author-id type="integer">1</author-id>
    
			<created-at type="datetime">2009-04-03T19:18:50+01:00</created-at>
    
			<id type="integer">20</id>
    
			<text>bbzbzb</text>
    
			<updated-at type="datetime">2009-04-03T19:18:50+01:00</updated-at>
    
		</comment>
    
	</comments>
    
</task>

  • JSON

    
handlerFunction({"task": {"ref_tags": [], "created_at": "2009/03/30 17:24:40 +0100", "author": {"name": "John", "created_at": "2009/03/17 15:05:51 +0000", "updated_at": "2009/04/06 13:17:08 +0100", "picture_url": "http://goplanapp.com/content/server.jpg", "user_type": 0, "alias": "john", "time_zone": "Lisbon", "email": "[email protected]"}, "title": "teste", "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "description": "teste", "parent_id": 20, "due_date": null, "cid": 19, "tags": [{"name": "testes"}], "status": 0, "comments": [{"created_at": "2009/04/03 19:18:50 +0100", "updated_at": "2009/04/03 19:18:50 +0100", "text": "bbzbzb", "id": 20, "author_id": 1}]}})

create

creates a new task (or sub-task) and returns it

Parameters

  • task[title]: TASK_TITLE (title of the new task) - mandatory
  • task[description]: TASK_DESCRIPTION (description of the new task) - not mandatory
  • task[due_date]: TASK_DUE_DATE (due date of the new task) - not mandatory
  • task[parent_id]: TASK_PARENT_ID (parent_id of the new task - TASK_ID of the parent task) - not mandatory (if present, creates a new sub-task)
  • task[category_id]: TASK_CATEGORY_ID (category_id of the new task) - not mandatory (ignored if creating a subtask)
  • tags[]: TAG_TEXT (use one tags[]=tagtext for each tag on the item. Specify project-wide hot-links with the notation ITEM_TYPE:ITEM_CID i.e.: ticket:3) - not mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/project_alias/api/tasks/create - pass the other parameters by POST

	http://company_alias.goplanapp.com/api/tasks/create?format=json&callback;=handlerfunction&project;=project_alias&task;[title]=design&task;[description]=build homepage&task;[parent_id]=15&task;[due_date]=Tue Apr 07 2009 19:08:36 GMT+0100 (CET) - a subtask, date can be passed in any format that can be parsed by Ruby's Date.parse(). Javascript Date object .toString() is accepted.

	http://company_alias.goplanapp.com/api/tasks/create?format=json&callback;=handlerfunction&project;=project_alias&task;[title]=design&task;[description]=build homepage&task;[category_id]=4&task;[due_date]=Tue Apr 07 2009 19:08:36 GMT+0100 (CET) - a root task on a specific category. If no category is specified, the task will go to the Uncategorized pseudo-category

	http://company_alias.goplanapp.com/api/tasks/create?format=json&callback;=handlerfunction&project;=project_alias&task;[title]=design&task;[description]=build homepage&tags;[]=design&tags;[]=brainstorm&tags;[]=important - an Uncategorized root task without due date and with tags

Output Formats

  • XML

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task>
    
	<cid type="integer">18</cid>
    
	<created-at type="datetime">2009-03-30T17:23:44+01:00</created-at>
    
	<description>build the homepage</description>
    
	<due-date type="date" nil="true"></due-date>
    
	<id type="integer">20</id>
    
	<parent-id type="integer" nil="true"></parent-id>
    
	<status type="integer">0</status>
    
	<title>teste</title>
    
	<updated-at type="datetime">2009-03-30T17:23:44+01:00</updated-at>
    
	<ref-tags type="array"/>
    
	<author>
    
		<alias>john</alias>
    
		<created-at type="datetime">2009-03-17T15:05:51+00:00</created-at>
    
		<email>@[email protected]</email>
    
		<name>John</name>
    
		<picture-url>http://goplanapp.com/content/server.jpg</picture-url>
    
		<time-zone>Lisbon</time-zone>
    
		<updated-at type="datetime">2009-04-06T13:17:08+01:00</updated-at>
    
		<user-type type="integer">0</user-type>
    
	</author>
    
	<tags type="array">
    
		<tag>
    
			<name>testes</name>
    
		</tag>
    
	</tags>
    
	<comments type="array"/>
    
</task>

  • JSON

    
handlerFunction({"task": {"ref_tags": [], "created_at": "2009/03/30 17:24:40 +0100", "author": {"name": "John", "created_at": "2009/03/17 15:05:51 +0000", "updated_at": "2009/04/06 13:17:08 +0100", "picture_url": "john", "user_type": 0, "alias": "john", "time_zone": "Lisbon", "email": "[email protected]"}, "title": "teste", "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "description": "build the homepage", "parent_id": 20, "due_date": null, "cid": 19, "tags": [{"name": "testes"}], "status": 0, "comments": []}})

destroy

deletes a task from the project and returns it

Parameters

  • id: TASK_CID (project-wide unique task identifier #) - mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/projectalias/api/tasks/destroy/6

	http://company_alias.goplanapp.com/api/tasks/destroy?id=6&project;=projectalias&format;=json&callback;=handler

Output Formats

  • XML

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task>
    
	<cid type="integer">18</cid>
    
	<created-at type="datetime">2009-03-30T17:23:44+01:00</created-at>
    
	<description>build the homepage</description>
    
	<due-date type="date" nil="true"></due-date>
    
	<id type="integer">20</id>
    
	<parent-id type="integer" nil="true"></parent-id>
    
	<status type="integer">0</status>
    
	<title>teste</title>
    
	<updated-at type="datetime">2009-03-30T17:23:44+01:00</updated-at>
    
	<ref-tags type="array"/>
    
	<author>
    
		<alias>john</alias>
    
		<created-at type="datetime">2009-03-17T15:05:51+00:00</created-at>
    
		<email>[email protected]</email>
    
		<name>John</name>
    
		<picture-url>http://goplanapp.com/content/server.jpg</picture-url>
    
		<time-zone>Lisbon</time-zone>
    
		<updated-at type="datetime">2009-04-06T13:17:08+01:00</updated-at>
    
		<user-type type="integer">0</user-type>
    
	</author>
    
	<tags type="array">
    
		<tag>
    
			<name>testes</name>
    
		</tag>
    
	</tags>
    
	<comments type="array">
    
		<comment>
    
			<author-id type="integer">1</author-id>
    
			<created-at type="datetime">2009-04-03T19:18:50+01:00</created-at>
    
			<id type="integer">20</id>
    
			<text>bbzbzb</text>
    
			<updated-at type="datetime">2009-04-03T19:18:50+01:00</updated-at>
    
		</comment>
    
	</comments>
    
</task>

  • JSON

    
handlerFunction({"task": {"ref_tags": [], "created_at": "2009/03/30 17:24:40 +0100", "author": {"name": "John", "created_at": "2009/03/17 15:05:51 +0000", "updated_at": "2009/04/06 13:17:08 +0100", "picture_url": "http://goplanapp.com/content/server.jpg", "user_type": 0, "alias": "john", "time_zone": "Lisbon", "email": "[email protected]"}, "title": "teste", "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "description": "build the homepage" "parent_id": 20, "due_date": null, "cid": 19, "tags": [{"name": "testes"}], "status": 0, "comments": [{"created_at": "2009/04/03 19:18:50 +0100", "updated_at": "2009/04/03 19:18:50 +0100", "text": "bbzbzb", "id": 20, "author_id": 1}]}})

update

updates an existing task and returns it

Parameters

  • id: TASK_CID (project-wide unique task identifier #) - mandatory
  • task[title]: TASK_TITLE (title of the new task) - not mandatory
  • task[description]: TASK_DESCRIPTION (description of the new task) - not mandatory
  • task[due_date]: TASK_DUE_DATE (due date of the new task) - not mandatory
  • task[category_id]: TASK_CATEGORY_ID (category_id of the new task) - not mandatory (ignored if editing a subtask)
  • tags[]: TAG_TEXT (use one tags[]=tagtext for each tag on the item. Specify project-wide hot-links with the notation ITEM_TYPE:ITEM_CID i.e.: ticket:3) - not mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/project_alias/api/tasks/update - pass the other parameters by POST

	http://company_alias.goplanapp.com/api/tasks/update?id=5format=json&callback;=handlerfunction&project;=project_alias&task;[title]=design&task;[parent_id]=15&task;[due_date]=Tue Apr 07 2009 19:08:36 GMT+0100 (CET) - a subtask, date can be passed in any format that can be parsed by Ruby's Date.parse(). Javascript Date object .toString() is accepted.

	http://company_alias.goplanapp.com/api/tasks/update/5?format=json&callback;=handlerfunction&project;=project_alias&task;[title]=design&tags;[]=design&tags;[]=brainstorm&tags;[]=important - an Uncategorized root task without due date and with tags

Output Formats

  • XML

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task>
    
	<cid type="integer">18</cid>
    
	<created-at type="datetime">2009-03-30T17:23:44+01:00</created-at>
    
	<description>build the homepage</description>
    
	<due-date type="date" nil="true"></due-date>
    
	<id type="integer">20</id>
    
	<parent-id type="integer" nil="true"></parent-id>
    
	<status type="integer">0</status>
    
	<title>teste</title>
    
	<updated-at type="datetime">2009-03-30T17:23:44+01:00</updated-at>
    
	<ref-tags type="array"/>
    
	<author>
    
		<alias>john</alias>
    
		<created-at type="datetime">2009-03-17T15:05:51+00:00</created-at>
    
		<email>[email protected]</email>
    
		<name>John</name>
    
		<picture-url>http://goplanapp.com/content/server.jpg</picture-url>
    
		<time-zone>Lisbon</time-zone>
    
		<updated-at type="datetime">2009-04-06T13:17:08+01:00</updated-at>
    
		<user-type type="integer">0</user-type>
    
	</author>
    
	<tags type="array">
    
		<tag>
    
			<name>testes</name>
    
		</tag>
    
	</tags>
    
	<comments type="array"/>
    
</task>

  • JSON

    
handlerFunction({"task": {"ref_tags": [], "created_at": "2009/03/30 17:24:40 +0100", "author": {"name": "John", "created_at": "2009/03/17 15:05:51 +0000", "updated_at": "2009/04/06 13:17:08 +0100", "picture_url": "http://goplanapp.com/content/server.jpg", "user_type": 0, "alias": "john", "time_zone": "Lisbon", "email": "[email protected]"}, "title": "teste", "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "description": "build the homepage", "parent_id": 20, "due_date": null, "cid": 19, "tags": [{"name": "testes"}], "status": 0, "comments": []}})

Task Categories

Fields

id
task category unique identifier number
name
task category name
created_at
task category creation time
updated_at
task category last update time
tasks
an array of Tasks - only when getting tasks

Methods

create

creates a new task category and returns it

Parameters

  • task_category[name]: TASK_CATEGORY_NAME (name of the new task category) - mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/project_alias/api/task_categories/create - pass the other parameters by POST

	http://company_alias.goplanapp.com/api/task_categories/create?format=json&callback;=handlerfunction&project;=project_alias&task;_category[name]=design

Output Formats

  • XML

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task-category>
    
	<created-at type="datetime">2009-03-26T19:08:00+00:00</created-at>
    
	<id type="integer">4</id>
    
	<name>Development</name>
    
	<updated-at type="datetime">2009-04-02T14:37:45+01:00</updated-at>
    
</task-category>

  • JSON

    
handlerFunction({"task": {"ref_tags": [], "created_at": "2009/03/30 17:24:40 +0100", "author": {"name": "John", "created_at": "2009/03/17 15:05:51 +0000", "updated_at": "2009/04/06 13:17:08 +0100", "picture_url": "http://goplanapp.com/content/server.jpg", "user_type": 0, "alias": "john", "time_zone": "Lisbon", "email": "[email protected]"}, "title": "teste", "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "parent_id": 20, "due_date": null, "cid": 19, "tags": [{"name": "testes"}], "status": 0, "comments": []}})

destroy

deletes an existing task category and returns it

Parameters

  • id: TASK_CATEGORY_ID (task category's unique identifier number) - mandatory
  • project: PROJECT_ALIAS (alias of a specific project) - mandatory
  • company: COMPANY_ALIAS (passed in as a subdomain) - mandatory
  • format: xml | json - not mandatory, defaults to the HTTP Accept header.
  • callback: JAVASCRIPT_FUNCTION (a javascript function identifier) - not mandatory, only used on json

Endpoint examples


	http://company_alias.goplanapp.com/project_alias/api/task_categories/destroy/2

	http://company_alias.goplanapp.com/api/task_categories/destroy?format=json&callback;=handlerfunction&project;=project_alias&id;=4

Output Formats

  • XML

    
<?xml version="1.0" encoding="UTF-8"?>
    
<task-category>
    
	<created-at type="datetime">2009-03-26T19:08:00+00:00</created-at>
    
	<id type="integer">4</id>
    
	<name>Development</name>
    
	<updated-at type="datetime">2009-04-02T14:37:45+01:00</updated-at>
    
</task-category>

  • JSON

    
handlerFunction({"task": {"ref_tags": [], "created_at": "2009/03/30 17:24:40 +0100", "author": {"name": "John", "created_at": "2009/03/17 15:05:51 +0000", "updated_at": "2009/04/06 13:17:08 +0100", "picture_url": "http://goplanapp.com/content/server.jpg", "user_type": 0, "alias": "john", "time_zone": "Lisbon", "email": "[email protected]"}, "title": "teste", "updated_at": "2009/03/30 17:24:40 +0100", "id": 21, "parent_id": 20, "due_date": null, "cid": 19, "tags": [{"name": "testes"}], "status": 0, "comments": []}})

Follow us on Twitter and Facebook. Talk to us and Get Satisfaction.

Goplan is a product of Reinhardt Media, Ltd. | Contact support | Terms of Service