Developer's API Documentation : Error Codes
When an error happens, Toodledo's API will respond with a unique error code and description in either json or xml depending on what format you requested.
Examples:
JSON: {"errorCode":102,"errorDesc":"Invalid authorization code"}
XML: <error id="102">Invalid authorization code</error>
Here is a list of the errors that you may encounter.
General
- 0 : Unknown Error
- 1 : No access token was given. Will also set a 401 HTTP status code. Read More...
- 2 : The access token was invalid or had the wrong scope. Will also set a 401 HTTP status code.
- 3 : Too many API requests. Will also set a 429 HTTP status code. Read More...
- 4 : The API is offline for maintenance. Will also set a 503 HTTP status code.
account/token.php
- 101 : SSL connection is required when requesting a token. Read More...
- 102 : There was an error requesting a token. See error description for more details.
- 103 : Too many token requests. Will also set a 429 HTTP status code. Read More...
folders/add.php
folders/edit.php
folders/delete.php
- 201 : Your folder must have a name.
- 202 : A folder with that name already exists.
- 203 : Max folders reached.
- 204 : Empty id.
- 205 : Invalid folder.
- 206 : Nothing was edited.
contexts/add.php
contexts/edit.php
contexts/delete.php
- 301 : Your context must have a name.
- 302 : A context with that name already exists.
- 303 : Max contexts reached.
- 304 : Empty id.
- 305 : Invalid context.
- 306 : Nothing was edited.
goals/add.php
goals/edit.php
goals/delete.php
- 401 : Your goal must have a name.
- 402 : A goal with that name already exists.
- 403 : Max goals reached.
- 404 : Empty id.
- 405 : Invalid goal.
- 406 : Nothing was edited.
locations/add.php
locations/edit.php
locations/delete.php
- 501 : Your location must have a name.
- 502 : A location with that name already exists.
- 503 : Max locations reached.
- 504 : Empty id.
- 505 : Invalid location.
- 506 : Nothing was edited.
tasks/add.php
tasks/edit.php
tasks/delete.php
tasks/reassign.php
tasks/share.php
- 601 : Your task must have a title.
- 602 : Only 50 tasks can be added/edited/deleted at a time.
- 603 : Max tasks reached
- 604 : Empty id
- 605 : Invalid task
- 606 : Nothing was added/edited
- 607 : Invalid folder id
- 608 : Invalid context id
- 609 : Invalid goal id
- 610 : Invalid location id
- 611 : Malformed request
- 612 : Invalid parent id
- 613 : Incorrect field parameters
- 614 : Parent was deleted
- 615 : Invalid collaborator
- 616 : Unable to reassign or share task
- 617 : Requires Toodledo subscription
notes/add.php
notes/edit.php
notes/delete.php
- 701 : Your note must have a name.
- 702 : Only 50 notes can be added/edited/deleted at a time.
- 703 : Max notes reached
- 704 : Empty id
- 705 : Invalid note
- 706 : Nothing was added/edited
- 707 : Invalid folder id
- 711 : Malformed request
outlines/add.php
outlines/edit.php
outlines/delete.php
- 801 : Outline had no title
- 802 : Only 50 outlines can be added/edited/deleted at a time.
- 803 : Max outlines reached
- 804 : Empty id / nothing sent
- 805 : Invalid outline
- 806 : Nothing was added/edited
- 807 : Invalid outline id
- 808 : Max nodes reached
- 809 : Outline already added
- 811 : Malformed request
- 812 : Reference was empty
- 813 : Invalid outline format
- 814 : Editing wrong version
lists/add.php
lists/edit.php
lists/delete.php
- 901 : List had no title
- 902 : Only 50 lists can be added/edited/deleted at a time.
- 903 : Max lists reached
- 904 : Empty id / nothing sent
- 905 : Invalid list
- 906 : Nothing was added/edited
- 909 : List already added
- 911 : Malformed request
- 912 : Reference was empty
- 913 : Invalid cols format
- 914 : Editing wrong version
rows/add.php
rows/edit.php
rows/delete.php
- 1001 : Row had no cells
- 1002 : Only 50 rows can be added/edited/deleted at a time.
- 1003 : Max rows reached
- 1004 : Empty id / nothing sent
- 1005 : Invalid list
- 1006 : Nothing was added/edited
- 1007 : Invalid row
- 1009 : Row already added
- 1011 : Malformed request
- 1012 : Reference was empty
- 1013 : Invalid cells format
- 1014 : Editing wrong version