todo/create

Description

This operation creates a todo on a project.

URI

POST creates the todo
http://ws.planzone.com/v1/rest/todos/create

Requires Authentication (about authentication):

yes

Requires Authorization (about authorization):

The application must have the 'write' permission granted from the Planzone.

The user must have access to the project, that is he must be a team member and be allowed to create a todo on the project.

API rate limited (about rate limiting):

yes

Parameters

NameOptionalDescription
projectNOThe project GUID. The project must exist and be open. The user must have the permission to create a todo in the project.
titleNOThe toto title. The title must not be empty. The length is limited to X characters.
descriptionYESThe todo description.
assignYESThe list of user GUID assigned to the new todo. The special GUID me represents the current user.
dateYESThe todo due date.
priorityYESThe todo priority.

Request Example

The following request:

POST /v1/rest/todos/create project=Bcd234hj&title=Write the report&assign=me

creates a new todo and assigns it to the current user.

Response

The response contains a Location header that gives the URL to get the todo information.

HTTP Status Codes

201 CREATED The todo has been created
403 FORBIDDEN The todo cannot be created (user is not member of the project or is not allowed to create todos on the project).
404 NOT FOUND The project cannot be found

References

Planzone API

See also

planzones
todos
todo/uncomplete
todo/complete
todo XML element