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


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