API

Build cool stuff that works with Remember The Milk.

menu

Overview

The Remember The Milk API consists of a set of callable methods and API endpoints. The arguments, responses, and error codes for each method are listed in the Methods section.

To perform an action using the Remember The Milk API, send a request (specifying a method and some parameters) using your desired request format to an API endpoint. A response will then be sent back to you.

All request formats (listed on the API page) take a list of named parameters.

The required parameter method is used to specify the method to be called.

The required parameter api_key is used to specify your API Key.

The optional parameter format is used to specify a response format.

The optional parameter v is used to specify an API version.

Encoding

The Remember The Milk API expects all data to be UTF-8 encoded.

All data is converted to UTF-8 before being stored.

IDs

All IDs returned by the Remember The Milk API should be treated as opaque string values.

Dates

The Remember The Milk API expects all dates and times to be in ISO 8601 format and UTC based.

All dates and times returned by the Remember The Milk API are in this format.

It is currently 2024-11-28T09:58:32Z UTC in ISO 8601 format.

Permissions

The Remember The Milk API has 3 permission levels. A permission level is usually requested during the authentication process with the perms parameter.

Valid perms values are:

  • read – gives the ability to read task, contact, group and list details and contents.
  • write – gives the ability to add and modify task, contact, group and list details and contents (also allows you to read).
  • delete – gives the ability to delete tasks, contacts, groups and lists (also allows you to read and write).