describe: document the API